항목값
이름FIELD (규격 문서 BIND FIELD)
TAG ID0x0BCL
코덱 ID0x00000BC0
규격 문서0x00000000/codecs/0x00000BC0/ (DECLARE 대상 0BC0)
섹션5 0101 (Edge 서술), 섹션 안 오프셋 C = 28
KindEdge · 계열: 서술, 묶음: 기타
TAG WORD0000 1011 1100 LLLL (000K KKKC CCCC LLLL)
색인 설명Payload 필드 하나. 속한 DECLARE, 폭: 레코드(TAG의 Length) 또는 날값 n WORD
Hugo 쪽edge/field.md

필드 (규격 문서)

FIELD의 문서 안 순서가 Payload 필드 순서다(Codec 규격 문서). Edge의 Edge Id는 FIELD로 선언하지 않는다.

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1declare#2레코드0050 LOCAL
2width#3날값 1 WORD0x0000 record, 0xFFFF rest

FIELD는 Codec Payload의 필드 하나를 선언하는 서술 Edge다. Codec 0x0BCL.

FIELD가 자기 DECLARE를 가리킨다. 한 DECLARE를 가리키는 FIELD들이 문서 안 순서대로 Payload를 구성한다. 레이아웃은 디코더에 내장한다(Codec 규격 문서).

레이아웃

TAG WORD          0000 1011 1100 LLLL
Edge Id           LOCAL Reference 레코드
DECLARE           LOCAL Reference 레코드. 이 필드가 속한 DECLARE Edge
폭                1 WORD. 0 = 레코드, n (1~65534) = 날값 n WORD, 0xFFFF = 나머지 날값

해석과 유효성

  • DECLARE는 같은 문서의 DECLARE Edge를 가리킨다. FIELD 하나는 DECLARE 하나에만 속한다. 순서는 따로 적지 않으며 FIELD 레코드가 문서에 놓인 순서다.
  • FIELD 규격 문서는 DECLARE를 폭 0(레코드), CODEC 0050(LOCAL)인 필드로 선언한다. 그래서 뷰어 그래프에서 FIELD → DECLARE 연결로 그려진다.
  • 폭 0은 레코드 필드다. TAG WORD로 시작하고 그 TAG의 Length만큼 읽는다(DECLARE 해석 규칙).
  • 폭 n(1~65534)은 날값 필드다. 언제나 정확히 n WORD다.
  • 폭 0xFFFF는 나머지 날값이다. DECLARE에 하나만 두며 앞·중간·끝 어디든 된다. 폭은 바깥 레코드의 TAG Length가 정한 남은 WORD에서 뒤 필드들의 폭을 뺀 값이다. 그래서 나머지 필드 뒤의 필드는 모두 고정 폭 날값이어야 한다(레코드는 앞에서부터 읽어야 끝을 알 수 있다). 0 WORD일 수 있다. ENUM을 붙이지 않는다.
  • 필드가 받는 Kind·Codec은 CODEC으로 지정한다. 레코드 필드는 CODEC이 없으면 아무 레코드나 받고, 있으면 그중 하나여야 한다. 날값 필드에 CODEC을 하나 두면 그 날값을 TAG를 뺀 그 Value로 해석한다.
  • 필드 이름은 FIELD Edge Id에 BIND로 묶는다(예: doc, hash). DECLARE·FIELD·ENUM·CODEC에 붙이는 UTF8-TEXT는 모두 BIND로 하며, LABEL 등 다른 Edge로 붙이지 않는다.
  • 날값 필드의 코드값 의미는 ENUM으로 붙인다.
  • 그래프에서 다른 노드를 가리키는 필드는 따로 표시하지 않는다. 레코드 필드가 Reference면 그것이 연결이다.

길이

전체 = 1 + 2 + 2 + 1 WORD   (Edge Id·DECLARE가 LOCAL 1 WORD ID일 때)

예시 (비규범)

  • 레코드 필드: Edge Id 7, DECLARE #1, 폭 0. TAG 1 + Edge Id 2 + DECLARE 2 + 폭 1 = 6 WORD. LOCAL만 받게 하려면 CODEC 예시를 본다.
0BC5 0051 0007 0051 0001 0000
  • 내용 해시 같은 날값 필드는 DECLARE 예시를 본다.

관련 페이지

규격 문서 원문

규격 문서 0x00000000/codecs/0x00000BC0/latest.geul을 geul show로 읽은 모습이다(16진은 대문자).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BC000000000
BODY
#1 DECLARE 0x0BC0
#2 FIELD #1 record
#13 CODEC #2 0x0050
#3 FIELD #1 0x0001
#5 ENUM #3 0x0000
#6 ENUM #3 0xFFFF
#7 BIND #1 "FIELD"
#8 BIND #2 "declare"
#9 BIND #3 "width"
#11 BIND #5 "record"
#12 BIND #6 "rest"