項目値
名前FIELD (規格ドキュメント BIND FIELD)
TAG ID0x0BCL
Codec 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"