ПунктЗначение
ИмяLOCAL (группа 5Q; имена по кодам — в таблице членов ниже)
TAG ID0x005L~0x009L
Раздел0 0000 (сущность Reference), смещение внутри раздела C = 5~9
KindReference · классификация: объявление
Сторона Hugoreference/local.md

Члены

Эта страница охватывает один комплект системы 5Q — пять кодов. Квантификация определяется смещением внутри раздела C % 5 (Reference). Документ кодека — по одному на код. Поля у пяти документов кодека одинаковы, различаются только цель 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 — объявляющий Reference, указывающий на цель по ID, выданному этим документом. Он ссылается на цели внутри документа без внешнего Issuer. Чтобы указывать на цель извне документа, в документ помещают Meta DOC-ID, и другие документы указывают на него указывающим Reference.

Раскладка

TAG WORD          0000 0000 0101 LLLL      Codec 0x005L~0x009L (Identified 0x005L)
[расширяющий TAG Length]
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). TAG WORD для Identified — 0000 0000 0101 LLLL.
  • Действует общее правило Reference: ID цели записывают наименьшим числом WORD.

Edge Id

  • LOCAL, являющийся первым элементом Payload Edge, — это объявление Edge Id данного Edge (Edge). Для объявления Edge Id используют только Identified (0x005L).
  • LOCAL на любом другом месте Payload Edge — упоминание. Цель этого документа при каждом упоминании записывают как LOCAL. Отдельного указывающего кода для целей этого документа нет.

Выдача идентификаторов

  • ID — целое число, назначаемое кодировщиком. Величина числа и порядок выдачи не имеют никакого смысла, кроме тождества.
  • UNIQUE (обязательно). В одном документе один LOCAL ID указывает только на одну цель. Edge Id объявляется в документе только один раз (HEAD Edge и BODY Edge используют одно пространство номеров). Если один и тот же Edge Id объявляют два или более Edge, это invalid.
  • AUTO INCREMENT (рекомендуется). Новый ID назначают как максимум из уже выданных в этом документе ID плюс 1, так что ID растут в порядке документа. То же и между версиями (новое создают со значением больше удалённого ID). Это лишь рекомендация, а не условие действительности; документ, где ID не растут, тоже valid. Декодер не полагается ни на величину ID, ни на их непрерывность.
  • ID 0 не назначают. Он не указывает ни на какую цель и не используется как Edge Id. ID цели назначают начиная с 1.
  • На документ — и внутри этого документа, и снаружи — указывают только одним DOC-POINTER (на самого себя — DOC-POINTER на собственный DOC-ID). К документу тоже можно присоединять BIND, LABEL и Edge вердикта.
  • На сам Issuer указывают через ISSUER-POINTER. Документ с ID 0 — индексный документ определений терминов Issuer.
  • Codec, придающие смысл 0 на месте компонента («нет» в REF и исполняемом Edge TOULMIN, «документ целиком» в Target HEAD SOURCE), следуют правилам этого Codec. Это договорённость внутри данного Codec, отличная от маркера места.
  • Однажды назначенный ID в том же документе повторно не используют.
  • Всегда используют наименьшую ширину, способную выразить значение.

Тождество и область действия

  • Если в одном документе целые значения LOCAL ID равны, это одна и та же цель. Ширина кодирования не входит в тождество.
  • Identified LOCAL обозначает идентифицированную цель. Его не используют как анонимный, неопределённый, null или sentinel. Высказывания «значение есть, но неизвестно» (UNKNOWN-VALUE) и «значения нет» (NO-VALUE) записывают маркером места в поле, принимающем такой маркер.
  • Разные LOCAL ID — это лишь разные Reference; это не значит, что и цели в реальности различны.
  • Тождество LOCAL не распространяют за пределы документа. Такое же число в другом документе ничего не значит.
  • Variable (0x009L) LOCAL — именованная переменная дискурса (Reference Variable).

Слияние

При слиянии нескольких документов в один для каждого исходного документа строят таблицу соответствия old ID → new ID, заново назначают все LOCAL ID по ID нового документа и заменяют все ссылки.

  • ID, равные в одном исходном документе, должны оставаться равными и после слияния.
  • Одинаковые числа из разных исходных документов ничего не значат и автоматически не сливаются в один Reference.
  • Если остался хотя бы один LOCAL, который не удалось заменить, слияние отвергают.

Действительность

Следующие кодирования и назначения invalid.

  • Non-minimal кодирование с ведущим WORD 0x0000 (исключение — 0x0000, 1 WORD для значения 0)
  • Codec на месте объявления Edge Id не Identified (0x005L) или ID равен 0
  • Один ID назначен в одном документе разным целям
  • Один и тот же Edge Id объявлен в одном документе два или более раз

Пример

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

Связанные страницы

Исходный текст документа спецификации

Документ спецификации 0x00000000/codecs/0x00000050/latest.geul, прочитанный командой geul show (шестнадцатеричные значения в верхнем регистре).

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). У остальных членов (LOCAL-GENERIC, LOCAL-FREE-CHOICE, LOCAL-UNIVERSAL, LOCAL-VARIABLE) в документе кодека различаются только Codec ID в DOC-ID, цель DECLARE и имя, привязанное в #1 (BIND).