항목값
이름CODEC (규격 문서 BIND CODEC)
TAG ID0x0BEL
코덱 ID0x00000BE0
규격 문서0x00000000/codecs/0x00000BE0/ (DECLARE 대상 0BE0)
섹션5 0101 (Edge 서술), 섹션 안 오프셋 C = 30
KindEdge · 계열: 서술, 묶음: 기타
TAG WORD0000 1011 1110 LLLL (000K KKKC CCCC LLLL)
색인 설명필드가 받는 Kind·Codec 하나. 필드, 대상 WORD(000K KKKC CCCC LLLL, LLLL 0000 정확·1111 와일드카드(그 섹션 32칸 전체), 자리 표지는 정확한 대상 0000·0010·0020로만). 레코드 필드는 여러 개(닫힌 목록), 날값 필드는 하나(TAG 없는 그 Value)
Hugo 쪽edge/codec.md

필드 (규격 문서)

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

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1field#2레코드0050 LOCAL
2target#4날값 1 WORD

CODEC은 FIELD 하나가 받는 Kind·Codec 하나를 지정하는 서술 Edge다. Codec 0x0BEL.

ENUM이 날값 필드의 코드값 하나에 의미를 붙이듯, CODEC은 필드의 형식 하나를 붙인다. Edge 하나에 하나씩이라 여러 개를 지정할 수 있다. 레이아웃은 디코더에 내장한다(Codec 규격 문서).

레이아웃

TAG WORD          0000 1011 1110 LLLL
[Length 확장 TAG]
Edge Id           LOCAL Reference 레코드
필드              FIELD Edge를 가리키는 LOCAL Reference 레코드
대상              1 WORD. 000K KKKC CCCC LLLL (LLLL = 0000 정확, 1111 와일드카드)

대상 WORD

  • TAG WORD의 Codec 자리(섹션 KKKK와 CCCCC)를 그대로 둔다. 상위 3비트는 0이다. LLLL은 0000(정확) 또는 1111(와일드카드)이고, 다른 값은 invalid다.
  • 정확한 대상(LLLL = 0000)을 32비트로 쓴 값이 그 Codec의 코덱 ID다(예: LOCAL 0x0050 → 0x00000050, COORDINATE-EARTH 0x0640, UTF8-LANGUAGE-TEXT 0x0780). 그래서 대상이 곧 그 Codec 규격 문서를 가리킨다(Codec 규격 문서).
  • 홀짝 코드 쌍(텍스트·바이트열)도 정확한 코드로 지정한다. 짝수·홀수를 모두 받으려면 둘 다 둔다. 쌍을 묶어 해석하는 규칙은 두지 않는다(NUMERIC 0x064L/0x065L처럼 쌍이 아닌 인접 코드가 있다).

와일드카드 (LLLL = 1111)

  • LLLL = 1111이면 C 값과 무관하게 대상 WORD의 섹션 KKKK(32칸) 전체를 받는다. 같은 섹션 안이라면 C가 어느 값이든 뜻이 같다. 대상의 섹션과 레코드의 섹션이 같은지만 본다. 섹션을 넘어 받지는 않는다.
  • LLLL = 1111이면 섹션 첫 칸(C = 0)을 권고한다. 권고이고 강제가 아니다. 같은 섹션의 다른 C여도 유효하다.
  • Kind가 여러 섹션에 걸치면 섹션마다 CODEC을 나열한다.
대상뜻
000F·020F·040F아무 Reference (섹션 0~2, REFERENCE-ISSUER 포함)
060F·080F아무 Value (섹션 3·4, VALUE-ISSUER 포함)
0A0F·0C0F·0E0F·100F·120F·140F·160F·180F·1A0F아무 Edge (섹션 5~13, EDGE-ISSUER 포함)
1C0F·1E0F아무 Meta (섹션 14·15)
  • Reference 자리 표지(0x000L~0x002L)는 LLLL = 1111과 맞지 않는다(000F는 ABSENT·UNKNOWN-VALUE·NO-VALUE를 받지 않는다). 한편 Value 0x060L(BOOL)·Edge 0x0A0L(REFERENCE-NODE)처럼 섹션 첫 칸이 배정된 섹션도 LLLL = 1111이 그것을 포함한다(BOOL만 받으려면 LLLL = 0000인 0600).
  • LLLL = 1111인 대상은 규격 문서를 가리키지 않는다.
  • 양화 무관이나 묶음은 CODEC 나열(LLLL = 0000)로만 쓴다. 예: WIKIDATA-QID 양화 무관은 0140, 0150, 0160, 0170, 0180 다섯 개다.
  • Reference 5Q 체계의 코드에는 양화가 들어 있다. 대상은 양화까지 정확히 지정한다. 여러 Quantifier를 받으려면 CODEC을 여러 개 둔다. REFERENCE-ISSUER의 양화는 Issuer 문서가 정한다.

자리 표지 (대상 0000, 0010, 0020)

자리 표지는 Reference 섹션 0의 첫 세 칸 0x000L~0x002L에 배정한 1 WORD 레코드 묶음이다. 양화가 없다.

대상표지뜻
0000ABSENT적지 않음. 그 필드는 선택 필드다
0010UNKNOWN-VALUE알 수 없음. 값이 있다는 단언을 받는다
0020NO-VALUE없음. 값이 없다는 단언을 받는다
  • 수용 규칙: 표지는 그 필드의 CODEC 목록에 같은 WORD가 정확한 대상으로 있을 때만 유효하다. 와일드카드와 CODEC이 없는 레코드 필드(“아무 레코드”)는 표지를 받지 않는다. HEAD·BODY 레코드 자리, Edge Id 자리의 표지는 invalid다.
  • 표지 대상만 있는 목록(항상 표지)은 invalid다(0000만 있는 목록 규칙의 일반화). LLLL = 1111 대상이나 정확한 대상과 함께 쓴다(000F·020F·040F + 0000 = 아무 Reference 또는 생략).
  • 날값 필드에는 표지 대상을 둘 수 없다. 날값은 TAG가 없고 폭이 정해져 있어 1 WORD 표지가 들어갈 자리가 없다.
  • 표지의 뜻은 그것을 받는 Codec 규격이 정한다.

선택 필드 (대상 0000)

  • 레코드 필드의 CODEC 목록에 대상 0000을 두면 그 필드는 선택 필드다. 생략할 때는 그 자리에 WORD 0x0000 1 WORD를 쓴다. 이 1 WORD 레코드가 자리 표지 ABSENT(적지 않음)다.
  • 0x0000은 Reference, Codec 0x000L(Reserved), LLLL = 0000(전체 1 WORD)이다. 다른 레코드와 겹치지 않고, 규격을 모르는 디코더도 1 WORD 레코드로 건너뛴다.
  • 선택 필드도 자리는 항상 차지한다. 생략하면 반드시 0x0000을 쓰고 자리를 비우지 않는다(뒤쪽 필드여도 같다). 그래서 레코드 하나의 표기는 하나뿐이고, 분해는 위치만으로 정해진다. 선택 필드의 위치와 개수, 다른 필드와 목록이 겹치는지는 제약이 없다.
  • ABSENT는 선택 필드 자리에서만 유효하다. HEAD·BODY 레코드 자리, 필수 필드 자리, Edge Id 자리의 0x0000은 invalid다.
  • 생략은 “값이 없음"이 아니라 “적지 않음"이다. 세계에 관해 아무것도 단언하지 않는다. “값이 없다"는 NO-VALUE(0020)로 적는다. 생략이 무엇을 뜻하는지(예: TAG의 대상이 없으면 이 버전)는 각 형식의 명세가 정한다.

해석과 유효성

  • 필드는 같은 문서의 FIELD Edge다. 한 필드에 같은 대상을 두 번 두지 않는다.
  • 레코드 필드(폭 0): CODEC이 없으면 자리 표지를 뺀 아무 레코드나 받는다. 하나 이상 있으면 닫힌 목록이다. 그 필드의 레코드는 Kind·Codec(Reference는 Quantifier 포함)이 목록 중 하나여야 하고, 아니면 그 레코드는 규격을 따르지 않는다. ENUM이 열린 목록인 것과 다르다.
  • 날값 필드(폭 n ≥ 1, 또는 나머지 0xFFFF): CODEC은 정확한 대상 하나만 둔다(와일드카드 불가). 그 날값은 TAG를 뺀 그 Value의 Payload다. Kind·Codec은 CODEC이, Length는 FIELD 폭이 준다. 홀짝 코드는 지정한 코드가 바이트 수 홀짝을 정한다. 날값이 그 Value 규칙(길이 포함)을 따르지 않으면 그 레코드는 규격을 따르지 않는다.
  • 자리 표지는 목록의 정확한 대상으로만 대조한다. 선택 필드(대상 0000) 자리에 0x0000이 오면 생략이다. 그 밖의 레코드는 표지 대상을 뺀 목록으로 대조한다.
  • 날값 필드에 CODEC과 ENUM을 함께 둘 수 있다. CODEC은 형식, ENUM은 코드값의 이름이다(예: rank를 UNSIGNED-INTEGER로 두고 0·1·2를 ENUM으로).
  • CODEC의 Edge Id에 BIND로 이름을 붙일 수 있지만 필수가 아니다.
  • “Reference 또는 Value” 필드는 CODEC 5개(000F, 020F, 040F, 060F, 080F)로 쓴다.

길이

전체 = 1 + N_len + N_id + N_field + 1 WORD   (Edge Id·필드가 LOCAL 1 WORD ID면 6 WORD)

예시

LABEL 규격 문서 0x00000000/codecs/0x00000A40/에서 Object 필드(FIELD #3)가 UTF8-LANGUAGE-TEXT(짝수·홀수)와 LOCAL을 받는다. Edge Id 7~9.

0BE5 0051 0007 0051 0003 0780
0BE5 0051 0008 0051 0003 0790
0BE5 0051 0009 0051 0003 0050
  • TAG 0BE5(Edge, Codec 0x0BEL, LLLL = 0101, 6 WORD), Edge Id 0051 0007, 필드 0051 0003, 대상 0780.

관련 페이지

규격 문서 원문

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000BE000000000
BODY
#1 DECLARE 0x0BE0
#2 FIELD #1 record
#3 CODEC #2 0x0050
#4 FIELD #1 0x0001
#5 BIND #1 "CODEC"
#6 BIND #2 "field"
#7 BIND #4 "target"