EXTERNAL-POINTER é a Reference de indicação que aponta o LOCAL ID de um documento importado por IMPORT-DOC no HEAD.

ItemValor
NomeEXTERNAL-POINTER-4WORD (grupo 5Q. Os nomes por código estão na tabela de membros abaixo)
TAG ID0x02AL~0x02EL
Seção1 0001 (Reference EXTERNAL), deslocamento C na seção = 10~14
KindReference · classificação: indicação
Lado Hugoreference/external-pointer.md (essa página trata também de EXTERNAL-POINTER-1WORD e EXTERNAL-POINTER-2WORD)

Membros

Esta página trata de um conjunto do sistema 5Q, cinco códigos. A quantificação é o deslocamento na seção C % 5 (Reference). Há um documento de codec por código. Os campos dos cinco documentos de codec são iguais; só diferem o alvo do DECLARE e o nome (BIND).

TAG IDNomeQuantificaçãoCodec IDDocumento de especificaçãoTAG WORD
0x02ALEXTERNAL-POINTER-4WORD-IDENTIFIEDIdentified0x000002A00x00000000/codecs/0x000002A0/0000 0010 1010 LLLL
0x02BLEXTERNAL-POINTER-4WORD-GENERICGeneric0x000002B00x00000000/codecs/0x000002B0/0000 0010 1011 LLLL
0x02CLEXTERNAL-POINTER-4WORD-FREE-CHOICEFree-choice0x000002C00x00000000/codecs/0x000002C0/0000 0010 1100 LLLL
0x02DLEXTERNAL-POINTER-4WORD-UNIVERSALUniversal0x000002D00x00000000/codecs/0x000002D0/0000 0010 1101 LLLL
0x02ELEXTERNAL-POINTER-4WORD-VARIABLEVariable0x000002E00x00000000/codecs/0x000002E0/0000 0010 1110 LLLL

Campos (documento de especificação)

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

OrdemCampo (BIND)FIELDLarguraFormato aceito (CODEC)ENUM
1import-id#2valor bruto de 4 WORD
2target-id#3valor bruto restante (0xFFFF)

EXTERNAL-POINTER é a Reference de indicação que aponta o LOCAL ID de um documento importado por IMPORT-DOC no HEAD.

Layout

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (seção 1)
[TAG estendida de Length]
IMPORT ID         largura definida pelo Codec (1/2/4 WORD)
ID do alvo        todo o restante. LOCAL ID do documento importado, na menor largura
Codec (Identified, Generic, Free-choice, Universal, Variable)NomeLargura do IMPORT ID
0x020L~0x024LEXTERNAL-POINTER-1WORD1 WORD
0x025L~0x029LEXTERNAL-POINTER-2WORD2 WORD
0x02AL~0x02ELEXTERNAL-POINTER-4WORD4 WORD
  • A largura é determinada pelo número do sistema: se sistema − 6 (C / 5 do deslocamento C na seção) for 0, 1, 2, a largura é 1, 2, 4 WORD. A quantificação é C % 5.

  • Usa-se o Codec mais estreito em que cabe o valor do IMPORT ID.

  • O IMPORT ID é o valor atribuído pelo IMPORT-DOC deste documento. O EXTERNAL-POINTER não registra o Issuer. O Issuer e o ID do documento obtêm-se desse IMPORT-DOC. A versão também é definida por esse IMPORT-DOC (fixa ou mais recente).

  • Se o LOCAL ID do documento importado é o mesmo, é o mesmo alvo, tanto se usado como LOCAL dentro desse documento quanto como EXTERNAL-POINTER aqui.

  • Se for Variable, é uma variável LOCAL do documento importado.

Validade

  • É invalid se este documento não tiver um IMPORT-DOC que atribua esse IMPORT ID.
  • Se o IMPORT ID cabe num Codec mais estreito e se usa um mais largo, é rejeitado como non-minimal.
  • É invalid se o ID do alvo for 0. O próprio documento importado é apontado por DOC-POINTER.
  • WORD 0x0000 à frente no ID do alvo é proibido.

Exemplo

AlvoWORD sequence
LOCAL 5 do IMPORT ID 10202 0001 0005
LOCAL 65536 do IMPORT ID 10203 0001 0001 0000
LOCAL 5 do IMPORT ID 700000253 0001 1170 0005

Páginas relacionadas

Texto original do documento de especificação

Como o documento de especificação 0x00000000/codecs/0x000002A0/latest.geul aparece ao ser lido com geul show (hexadecimal em maiúsculas).

SPEC-VERSION 0x0001
DOC-ID 0x042600000000000002A000000000
BODY
#1 DECLARE 0x02A0
#2 FIELD #1 0x0004
#3 FIELD #1 rest
#4 BIND #1 "EXTERNAL-POINTER-4WORD-IDENTIFIED"
#5 BIND #2 "import-id"
#6 BIND #3 "target-id"

Acima está o documento de codec de EXTERNAL-POINTER-4WORD-IDENTIFIED (0x02AL). Os documentos de codec dos outros membros (EXTERNAL-POINTER-4WORD-GENERIC, EXTERNAL-POINTER-4WORD-FREE-CHOICE, EXTERNAL-POINTER-4WORD-UNIVERSAL, EXTERNAL-POINTER-4WORD-VARIABLE) diferem apenas no Codec ID do DOC-ID, no alvo do DECLARE e no nome ligado em #1 (BIND).