項目値
名前LOCAL (5Q グループ。コードごとの名前は下のメンバー表)
TAG ID0x005L~0x009L
セクション0 0000 (Reference エンティティ)、セクション内オフセット C = 5~9
KindReference · 分類: 宣言
Hugo 側reference/local.md

メンバー

このページは 5Q 体系の 1 セット、コード 5 つをまとめて扱う。量化はセクション内オフセット C % 5 だ(Reference)。Codec ドキュメントはコードごとに 1 つある。5 つの Codec ドキュメントはフィールドが同じで、DECLARE 対象と名前(BIND)だけが異なる。

TAG ID名前量化Codec ID規格ドキュメントTAG WORD
0x005LLOCAL-IDENTIFIEDIdentified0x000000500x00000000/codecs/0x00000050/0000 0000 0101 LLLL
0x006LLOCAL-GENERICGeneric0x000000600x00000000/codecs/0x00000060/0000 0000 0110 LLLL
0x007LLOCAL-FREE-CHOICEFree-choice0x000000700x00000000/codecs/0x00000070/0000 0000 0111 LLLL
0x008LLOCAL-UNIVERSALUniversal0x000000800x00000000/codecs/0x00000080/0000 0000 1000 LLLL
0x009LLOCAL-VARIABLEVariable0x000000900x00000000/codecs/0x00000090/0000 0000 1001 LLLL

フィールド (規格ドキュメント)

FIELD のドキュメント内の順序が Payload のフィールド順だ(Codec 規格ドキュメント)。

順序フィールド(BIND)FIELD幅受け取る形式(CODEC)ENUM
1local-id#2残り全部の生値(0xFFFF)

LOCAL は、このドキュメントが発行した ID で対象を指す宣言 Reference だ。外部 Issuer なしにドキュメント内の対象を参照する。ドキュメントの外から指すには、ドキュメントに Meta DOC-ID を置き、別のドキュメントが指示 Reference で指す。

レイアウト

TAG WORD          0000 0000 0101 LLLL      Codec 0x005L~0x009L (Identified 0x005L)
[Length 拡張 TAG]
LOCAL ID          最短幅の unsigned big-endian
LOCAL ID全体TAG WORD (Identified)
0..655352 WORD0x0051
65536..2^32-13 WORD0x0052
2^32..2^48-14 WORD0x0053
2^48..2^64-15 WORD0x0054
  • Codec は 0x005L(Identified)、0x006L(Generic)、0x007L(Free-choice)、0x008L(Universal)、0x009L(Variable)だ。Identified の TAG WORD は 0000 0000 0101 LLLL だ。
  • 対象 ID を最短の WORD 数で書く Reference 共通規則に従う。

Edge Id

  • Edge Payload の最初の要素である LOCAL が、その Edge の Edge Id 宣言だ(Edge)。Edge Id を宣言する LOCAL は Identified(0x005L)だけを使う。
  • Edge Payload のそれ以外の位置にある LOCAL は言及だ。このドキュメントの対象は、言及するたびに LOCAL で書く。このドキュメントの対象を指す指示コードは別にない。

識別子の割り当て

  • ID は整数で、エンコーダが割り当てる。数の大きさと割り当て順は、同一性以外に何の意味もない。
  • UNIQUE(必須)。 1 つのドキュメントで LOCAL ID 1 つは対象 1 つだけを指す。Edge Id はドキュメントごとに 1 回だけ宣言する(HEAD Edge と BODY Edge は 1 つの番号空間)。同じ Edge Id を宣言する Edge が 2 つ以上あれば invalid だ。
  • AUTO INCREMENT(推奨)。 新しい ID は、そのドキュメントでこれまでに割り当てた ID の最大値 + 1 で割り当て、ドキュメント順に増えるようにする。バージョンをまたいでも同じだ(削除した ID より大きい値で新しく作る)。推奨にすぎず有効性の条件ではなく、増加しないドキュメントも valid だ。デコーダは ID の大きさや連続性に依存しない。
  • ID 0 は割り当てない。どの対象も指さず、Edge Id にも使わない。対象 ID は 1 から割り当てる。
  • ドキュメントは、そのドキュメントの内でも外でも DOC-POINTER 1 つだけで指す(自分自身は自分の DOC-ID の DOC-POINTER)。ドキュメントにも BIND・LABEL・判定 Edge を付けられる。
  • Issuer 自身は ISSUER-POINTER で指す。ドキュメント ID 0 は Issuer の用語定義索引ドキュメントだ。
  • 構成要素位置の 0 に意味を与える Codec(TOULMIN REF・実行 Edge の「なし」、HEAD SOURCE Target の「ドキュメント全体」)は、その Codec の規則に従う。これはプレースホルダとは別の、その Codec 内の約束だ。
  • 一度割り当てた ID は、同じドキュメントで再利用しない。
  • 常に値を表現できる最小幅を使う。

同一性と範囲

  • 同じドキュメントで LOCAL ID の整数値が同じなら同じ対象だ。エンコード幅は同一性の一部ではない。
  • Identified LOCAL は識別された対象を表す。匿名・未指定・null・sentinel の用途には使わない。値はあるが分からない(UNKNOWN-VALUE)、あるいは値がない(NO-VALUE)という言明は、そのマーカーを受け取るフィールドにプレースホルダとして書く。
  • 異なる LOCAL ID は異なる Reference であるにすぎず、現実の対象まで異なるという意味ではない。
  • LOCAL の同一性をドキュメントの外へ広げない。別のドキュメントの同じ数字は無関係だ。
  • Variable(0x009L)LOCAL は名前付きの談話変数だ(Reference Variable)。

マージ

複数のドキュメントを 1 つにマージするときは、元のドキュメントごとに old ID → new ID の対応表を作り、すべての LOCAL ID を新しいドキュメントの ID に振り直して参照をすべて置き換える。

  • 同じ元ドキュメントで同じだった ID は、マージ後も同じでなければならない。
  • 異なる元ドキュメントの同じ数字は無関係で、自動的に同じ Reference にまとめない。
  • 置き換えられなかった LOCAL が 1 つでもあれば、マージを拒否する。

有効性

次のエンコードや割り当ては invalid だ。

  • 先頭に 0x0000 WORD がある non-minimal エンコード(値 0 の 0x0000 1 WORD は例外)
  • Edge Id 宣言位置の Codec が Identified(0x005L)でない、または ID が 0 の場合
  • 同じドキュメントで ID 1 つを異なる対象に重複して割り当てた場合
  • 同じドキュメントで同じ Edge Id を 2 回以上宣言した場合

例

LOCAL IDWORD sequence
10051 0001
655350051 FFFF
655360052 0001 0000
42949672950052 FFFF FFFF
1, Variable0091 0001

関連ページ

規格ドキュメント原文

規格ドキュメント 0x00000000/codecs/0x00000050/latest.geul を geul show で読んだ様子だ(16進は大文字)。

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000005000000000
BODY
#1 DECLARE 0x0050
#2 FIELD #1 rest
#3 BIND #1 "LOCAL-IDENTIFIED"
#4 BIND #2 "local-id"

上は LOCAL-IDENTIFIED(0x005L)の Codec ドキュメントだ。ほかのメンバー(LOCAL-GENERIC、LOCAL-FREE-CHOICE、LOCAL-UNIVERSAL、LOCAL-VARIABLE)の Codec ドキュメントは、DOC-ID の Codec ID、DECLARE 対象、#1 に結んだ名前(BIND)だけが異なる。