항목값
이름REFERENCE-NODE (규격 문서 BIND REFERENCE-NODE)
TAG ID0x0A0L
코덱 ID0x00000A00
규격 문서0x00000000/codecs/0x00000A00/ (DECLARE 대상 0A00)
섹션5 0101 (Edge 서술), 섹션 안 오프셋 C = 0
KindEdge · 계열: 서술, 묶음: 지시와 이름
TAG WORD0000 1010 0000 LLLL (000K KKKC CCCC LLLL)
색인 설명Reference인 Subject가 Object를 지시하는 방향성 바인딩
Hugo 쪽edge/reference-node.md

필드 (규격 문서)

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

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1subject#2레코드아무 레코드(자리 표지 제외)
2object#3레코드000F 섹션 0 전체(와일드카드, Reference), 020F 섹션 1 전체(와일드카드, Reference), 040F 섹션 2 전체(와일드카드, Reference), 060F 섹션 3 전체(와일드카드, Value), 080F 섹션 4 전체(와일드카드, Value)

REFERENCE-NODE는 Reference 하나를 Object 레코드 하나에 연결해, 그 Reference가 무엇인지 정의하거나 바인딩하는 방향성 서술 Edge다. Codec 0x0A0L.

Subject가 Object를 지시한다. 이 바인딩은 의미상 동일성을 주장하는 SAME-NODE가 아니며, 두 레코드의 byte가 같다는 뜻도 아니다.

레이아웃

TAG WORD          0000 1010 0000 LLLL
[Length 확장 TAG]
Edge Id           LOCAL Reference 레코드
Subject           Reference 레코드 1개
Object            Reference 또는 Value 레코드 1개

해석과 유효성

  • Subject는 정확히 하나의 완전한 Reference 레코드여야 한다. Subject 자체의 Length로 경계를 찾으며, Reference가 아니거나 불완전하면 invalid다.
  • Object는 정확히 하나의 완전한 Reference 또는 Value 레코드여야 한다. Object 자체의 Length로 경계를 찾으며, Edge·Meta이거나 불완전하면 invalid다.
  • Object가 Reference이면, REFERENCE-NODE 바인딩으로 따라가는 Reference 사슬은 순환하지 않아야 하며 LOCAL은 끝내 해소되어야 한다. 해소 순환과 dangling LOCAL은 invalid다.
  • 같은 문서에서 LOCAL ID 하나가 서로 충돌하는 Object로 바인딩되면 invalid다. LOCAL의 범위, ID, 최소 폭과 병합 규칙은 LOCAL을 따른다.
  • 모든 Reference가 REFERENCE-NODE로 바인딩되어야 하는 것은 아니다.
  • 대표 용례는 LOCAL → UTF8-LANGUAGE-TEXT다. LABEL의 Object에 LOCAL을 두었을 때, 같은 문서의 이 바인딩으로 텍스트를 해소한다.

Subject가 Object를 지시하는 방향을 거꾸로 해석해서는 안 된다. SAME과 DIFFERENT의 의미와 세부 규칙은 각 형식이 따로 정한다.

길이

전체 = 1 + N_len + N_id + N_subject + N_object WORD

N_len은 Length 확장 TAG WORD 수, N_id는 Edge Id LOCAL 레코드의 WORD 수, N_subject·N_object는 각 레코드의 전체 WORD 수다. Subject와 Object를 모두 읽은 커서는 Edge 끝과 정확히 맞아야 한다.

예시 (비규범)

Edge Id 0008, Subject는 LOCAL 1, Object는 Donald Trump(en)의 UTF8-LANGUAGE-TEXT다.

  • Edge Id는 0051 0008로 2 WORD다.
  • Subject는 0051 0001로 2 WORD다.
  • Object는 언어 0761 656E(BCP47 en) + 텍스트 12 byte(짝수)라 UTF8-LANGUAGE-TEXT-EVEN(0x078L), 전체 9 WORD다. TAG는 0788이다.
  • Edge는 TAG 1 + Edge Id 2 + Subject 2 + Object 9 = 14 WORD, LLLL=1101이다. TAG는 0A0D다.
0A0D 0051 0008 0051 0001 0788 0761 656E 446F 6E61 6C64 2054 7275 6D70

관련 페이지

규격 문서 원문

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A0000000000
BODY
#1 DECLARE 0x0A00
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "REFERENCE-NODE"
#5 BIND #2 "subject"
#6 BIND #3 "object"
#7 CODEC #3 0x000F
#9 CODEC #3 0x020F
#10 CODEC #3 0x040F
#8 CODEC #3 0x060F
#11 CODEC #3 0x080F