DOC-1WORD, DOC-2WORD und DOC-4WORD sind Struktur-Meta, die ein Dokument unter Angabe der Gesamtzahl seiner WORDs öffnen.

EintragWert
NameDOC-2WORD (Spezifikationsdokument BIND DOC-2WORD)
TAG ID0x1C1L
Codec ID0x00001C10
Spezifikationsdokument0x00000000/codecs/0x00001C10/ (DECLARE-Ziel 1C10)
Abschnitt14 1110 (Meta), Offset im Abschnitt C = 1
KindMeta · Klasse: Struktur
TAG WORD0001 1100 0001 LLLL (000K KKKC CCCC LLLL)
Beschreibung im IndexDokumentbeginn mit der Gesamtlänge in 2 WORD Payload
Hugo-Seitemeta/structure/doc.md (diese Seite behandelt auch DOC-1WORD und DOC-4WORD)

Felder (Spezifikationsdokument)

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

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1count#2Rohwert 2 WORD

Dies ist der Record, der ein Dokument öffnet. Er gibt im Payload die Gesamtzahl der WORDs des Dokuments an. DOC-1WORD (0x1C0L), DOC-2WORD (0x1C1L) und DOC-4WORD (0x1C2L) werden auf dieser Seite gemeinsam behandelt.

Layout

TAG WORD          0001 1100 0000 LLLL      Codec 0x1C0L
[Length-Erweiterungs-TAG]
Payload           Gesamtzahl der WORDs. Der Codec bestimmt die Breite: DOC-1WORD 1, DOC-2WORD 2, DOC-4WORD 4
  • Codec: Meta 0x1C0L~0x1C2L, Strukturklasse
  • Payload: Rohwert (Gesamtzahl der WORDs des Dokuments, unsigned)
  • Anzahl: eines pro Dokument, ganz am Anfang

Interpretation und Gültigkeit

  • Die Länge reicht vom Beginn des öffnenden Records bis zum Ende von END.
  • Verwendet wird die schmalste Breite, in die der Wert passt. Eine Kodierung in größerer Breite wird als nicht kanonische Kodierung abgelehnt.
  • Die Länge muss der gesamten Eingabe entsprechen. Ein Dokument ist eine Eingabe.
  • Mit dieser Länge kann der Decoder das gesamte Dokument überspringen. Einen Codec, der ohne Kenntnis der Länge öffnet, gibt es nicht.
  • Bei der Berechnung des Inhaltshashs wird mit der Länge ohne die Meta der Verifikationsklasse und der dazu passenden Breite neu geschrieben (Inhaltshash).

Beispiel

  • 0x1C01 0x0017: DOC-1WORD, insgesamt 23 WORD

Wortlaut des Spezifikationsdokuments

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

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C1000000000
BODY
#1 DECLARE 0x1C10
#2 FIELD #1 0x0002
#3 BIND #1 "DOC-2WORD"
#4 BIND #2 "count"