EintragWert
NameNEXT-LOCAL-ID (Spezifikationsdokument BIND NEXT-LOCAL-ID)
TAG ID0x1DDL
Codec ID0x00001DD0
Spezifikationsdokument0x00000000/codecs/0x00001DD0/ (DECLARE-Ziel 1DD0)
Abschnitt14 1110 (Meta), Offset im Abschnitt C = 29
KindMeta · Klasse: Abstammung
TAG WORD0001 1101 1101 LLLL (000K KKKC CCCC LLLL)
Beschreibung im IndexAls Nächstes zu vergebende LOCAL ID (auto increment). Steht im HEAD der Versionsliste versions.geul
Hugo-Seitemeta/lineage/next-local-id.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1next#2Rest-Rohwert (0xFFFF)

Hält die LOCAL ID fest, die die nächste Version des Dokuments einer neuen Aussage zuweist (auto increment eines DBMS, MySQL AUTO_INCREMENT). Jede in irgendeiner Version des Dokuments vergebene LOCAL ID ist kleiner als dieser Wert.

Layout

TAG WORD          0001 1101 1101 LLLL      Codec 0x1DDL
Payload           als Nächstes zu vergebende LOCAL ID, unsigned Ganzzahl in der schmalsten Breite
  • Codec: Meta 0x1DDL, Abstammungsklasse
  • Payload: Rohwert (unsigned Ganzzahl in der schmalsten Breite)
  • Anzahl: höchstens eines
  • Ablageort: HEAD des Versionslisten-Dokuments versions.geul (PUBLICATION)

Interpretation und Gültigkeit

  • Die LOCAL ID (einschließlich Edge Id) ist eine versionsübergreifende Identität (Revision). Eine neue Aussage erhält diesen Wert, und der Wert steigt um 1. Eine gelöschte LOCAL ID wird nicht wiederverwendet. Deshalb sinkt dieser Wert auch dann nicht, wenn die Aussage mit dem Höchstwert gelöscht wird.
  • Die LOCAL ID 0 wird nicht vergeben, daher ist der Anfangswert 1. Gibt es noch keine Version, steht dieses Meta nicht, und die nächste Nummer ist 1.
  • Die veröffentlichende Stelle aktualisiert und schreibt ihn in das neue Listendokument, wenn sie eine Version veröffentlicht. Er muss größer sein als jede in der veröffentlichten Version verwendete LOCAL ID. Ist er kleiner oder gleich, ist es invalid.
  • Der Wert wächst nur. Ist er kleiner als der Wert des unmittelbar vorangehenden Listendokuments (PARENT), ist es invalid.
  • Bei Dokumenten ohne Versionsverwaltung (Dokumente ohne versions.geul, namenlose Dokumente) gibt es ihn nicht. Solche Dokumente haben auch keinen Diff (DELTA-BASE).
  • Im Dokumentkörper (Versionsdokument) steht er nicht. Die Nummer zu merken ist nicht Dokumentinhalt, sondern Zustand der veröffentlichenden Stelle, die das Dokument fortschreibt (bei git nicht der Commit, sondern die Seite der refs).

Beispiel

Nächste zu vergebende Nummer 524:

1DD1 020C
  • TAG 1DD1(Meta 0x1DDL, LLLL=0001, 2 WORD), Payload 020C.

Wortlaut des Spezifikationsdokuments

So sieht das Spezifikationsdokument 0x00000000/codecs/0x00001DD0/latest.geul aus, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DD000000000
BODY
#1 DECLARE 0x1DD0
#2 FIELD #1 rest
#3 BIND #1 "NEXT-LOCAL-ID"
#4 BIND #2 "next"