DOC-1WORD, DOC-2WORD e DOC-4WORD são Meta de estrutura que abrem o documento indicando o número total de WORDs do documento.

ItemValor
NomeDOC-2WORD (BIND DOC-2WORD do documento de especificação)
TAG ID0x1C1L
Codec ID0x00001C10
Documento de especificação0x00000000/codecs/0x00001C10/ (alvo do DECLARE 1C10)
Seção14 1110 (Meta), deslocamento C = 1 na seção
KindMeta · classe: estrutura
TAG WORD0001 1100 0001 LLLL (000K KKKC CCCC LLLL)
Descrição do índiceInício de documento com o comprimento total indicado em 2 WORDs do Payload
Lado Hugometa/structure/doc.md (essa página trata também de DOC-1WORD e DOC-4WORD)

Campos (documento de especificação)

A ordem dos FIELD no documento é a ordem dos campos do Payload (documento de especificação do Codec).

OrdemCampo (BIND)FIELDLarguraFormato de entrada (CODEC)ENUM
1count#2valor bruto 2 WORD

Registro que abre o documento. Indica no Payload o número total de WORDs do documento. Esta página trata em conjunto de DOC-1WORD (0x1C0L), DOC-2WORD (0x1C1L) e DOC-4WORD (0x1C2L).

Layout

TAG WORD          0001 1100 0000 LLLL      Codec 0x1C0L
[TAG de extensão de Length]
Payload           Número total de WORDs. O Codec define a largura: DOC-1WORD 1, DOC-2WORD 2, DOC-4WORD 4
  • Codec: Meta 0x1C0L~0x1C2L, classe de estrutura
  • Payload: valor bruto (número total de WORDs do documento, sem sinal)
  • Quantidade: um por documento, no início

Interpretação e validade

  • O comprimento vai do início do registro de abertura até o fim de END.
  • Usa-se a menor largura em que o valor cabe. Codificar com uma largura maior é rejeitado como codificação não canônica.
  • O comprimento deve ser igual ao da entrada inteira. Um documento é uma entrada.
  • O decodificador pode saltar o documento inteiro usando esse comprimento. Não existe Codec que abra sem conhecer o comprimento.
  • Ao calcular o hash de conteúdo, reescreve-se com o comprimento sem os Meta da classe de verificação e a largura correspondente (hash de conteúdo).

Exemplo

  • 0x1C01 0x0017: DOC-1WORD, 23 WORDs no total

Texto do documento de especificação

É o documento de especificação 0x00000000/codecs/0x00001C10/latest.geul lido com geul show (hexadecimal em maiúsculas).

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