| Пункт | Значение |
|---|---|
| Имя | NEXT-LOCAL-ID (BIND документа спецификации NEXT-LOCAL-ID) |
| TAG ID | 0x1DDL |
| Codec ID | 0x00001DD0 |
| Документ спецификации | 0x00000000/codecs/0x00001DD0/ (цель DECLARE 1DD0) |
| Раздел | 14 1110 (Meta), смещение в разделе C = 29 |
| Kind | Meta · класс: родословная |
| TAG WORD | 0001 1101 1101 LLLL (000K KKKC CCCC LLLL) |
| Описание в индексе | LOCAL ID, который будет назначен следующим (auto increment). Ставится в HEAD списка версий versions.geul |
| Сторона Hugo | meta/lineage/next-local-id.md |
Поля (документ спецификации)
Порядок FIELD в документе — это порядок полей Payload (Документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | next | #2 | остаток, простое значение (0xFFFF) |
Указывает LOCAL ID, который следующая версия документа назначит новому высказыванию (auto increment в СУБД, MySQL AUTO_INCREMENT). Все LOCAL ID, назначенные в любой версии документа, меньше этого значения.
Раскладка
TAG WORD 0001 1101 1101 LLLL Codec 0x1DDL
Payload LOCAL ID, назначаемый следующим, unsigned целое наименьшей ширины
- Codec: Meta
0x1DDL, класс родословной - Payload: простое значение (unsigned целое наименьшей ширины)
- Количество: не более одного
- Место размещения: HEAD документа списка версий
versions.geul(PUBLICATION)
Интерпретация и валидность
- LOCAL ID (включая Edge Id) — идентичность, сохраняющаяся между версиями (Редакция). Новое высказывание получает это значение, и значение увеличивается на 1. Удалённый LOCAL ID повторно не используется. Поэтому даже если удалено высказывание с максимальным значением, это значение не уменьшается.
- LOCAL ID
0не назначается, поэтому начальное значение —1. Если версий ещё нет, эта Meta не ставится, а следующий номер —1. - Когда публикующая сторона публикует версию, она обновляет значение в новом документе-списке. Оно должно быть больше любого LOCAL ID, использованного в опубликованных версиях. Если меньше или равно — invalid.
- Значение только растёт. Если оно меньше значения в предыдущем документе-списке (PARENT), это invalid.
- В документах без управления версиями (документах без
versions.geul, безымянных документах) её нет. Для таких документов diff (DELTA-BASE) тоже не ставится. - В тело документа (документ версии) не ставится. Запоминание номера — это не содержимое документа, а состояние публикующей стороны, продолжающей документ (в git это не коммит, а сторона refs).
Пример
Следующий назначаемый номер 524:
1DD1 020C
- TAG
1DD1(Meta0x1DDL,LLLL=0001, 2 WORD), Payload020C.
Исходный текст документа спецификации
Документ спецификации 0x00000000/codecs/0x00001DD0/latest.geul, прочитанный командой geul show (16-ричные значения в верхнем регистре).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DD000000000
BODY
#1 DECLARE 0x1DD0
#2 FIELD #1 rest
#3 BIND #1 "NEXT-LOCAL-ID"
#4 BIND #2 "next"