EXTERNAL-POINTER est une Reference de désignation qui désigne le LOCAL ID d’un document importé par IMPORT-DOC du HEAD.

ÉlémentValeur
NomEXTERNAL-POINTER-1WORD (groupe 5Q. Noms par code dans le tableau des membres ci-dessous)
TAG ID0x020L~0x024L
Section1 0001 (Reference EXTERNAL), offset dans la section C = 0~4
KindReference · classification : désignation
Côté Hugoreference/external-pointer.md (cette page traite aussi de EXTERNAL-POINTER-2WORD et EXTERNAL-POINTER-4WORD)

Membres

Cette page traite d’un jeu complet du système 5Q, soit cinq codes. La quantification est l’offset dans la section C % 5 (Reference). Il y a un document de Codec par code. Les champs des cinq documents de Codec sont identiques ; seuls la cible DECLARE et le nom (BIND) diffèrent.

TAG IDNomQuantificationCodec IDDocument de spécificationTAG WORD
0x020LEXTERNAL-POINTER-1WORD-IDENTIFIEDIdentified0x000002000x00000000/codecs/0x00000200/0000 0010 0000 LLLL
0x021LEXTERNAL-POINTER-1WORD-GENERICGeneric0x000002100x00000000/codecs/0x00000210/0000 0010 0001 LLLL
0x022LEXTERNAL-POINTER-1WORD-FREE-CHOICEFree-choice0x000002200x00000000/codecs/0x00000220/0000 0010 0010 LLLL
0x023LEXTERNAL-POINTER-1WORD-UNIVERSALUniversal0x000002300x00000000/codecs/0x00000230/0000 0010 0011 LLLL
0x024LEXTERNAL-POINTER-1WORD-VARIABLEVariable0x000002400x00000000/codecs/0x00000240/0000 0010 0100 LLLL

Champs (document de spécification)

L’ordre des FIELD dans le document est l’ordre des champs du Payload (document de spécification de Codec).

OrdreChamp (BIND)FIELDLargeurFormat accepté (CODEC)ENUM
1import-id#2valeur brute 1 WORD
2target-id#3valeur brute restante (0xFFFF)

EXTERNAL-POINTER est une Reference de désignation qui désigne le LOCAL ID d’un document importé par IMPORT-DOC du HEAD.

Disposition

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (section 1)
[TAG d'extension de Length]
IMPORT ID         largeur fixée par le Codec (1/2/4 WORD)
ID de cible       tout le reste. LOCAL ID du document importé, sur la largeur la plus courte
Codec (Identified, Generic, Free-choice, Universal, Variable)NomLargeur de l’IMPORT ID
0x020L~0x024LEXTERNAL-POINTER-1WORD1 WORD
0x025L~0x029LEXTERNAL-POINTER-2WORD2 WORD
0x02AL~0x02ELEXTERNAL-POINTER-4WORD4 WORD
  • La largeur est fixée par le numéro de système : si système − 6 (C / 5, avec C l’offset dans la section) vaut 0, 1, 2, la largeur est 1, 2, 4 WORD. La quantification est C % 5.

  • On utilise le Codec le plus étroit dans lequel tient la valeur de l’IMPORT ID.

  • L’IMPORT ID est la valeur attribuée par IMPORT-DOC de ce document. EXTERNAL-POINTER n’indique pas d’Issuer. L’Issuer et l’ID de document s’obtiennent à partir de cet IMPORT-DOC. La version est aussi fixée par cet IMPORT-DOC (fixe ou la plus récente).

  • Pour un même LOCAL ID du document importé, c’est la même cible, qu’on l’écrive en LOCAL dans ce document ou en EXTERNAL-POINTER ici.

  • Pour Variable, c’est une variable LOCAL du document importé.

Validité

  • Si ce document n’a pas d’IMPORT-DOC qui attribue cet IMPORT ID, c’est invalid.
  • Si l’IMPORT ID tient dans un Codec plus étroit mais qu’on emploie un Codec plus large, on le rejette comme non-minimal.
  • Si l’ID de cible vaut 0, c’est invalid. Le document importé lui-même se désigne par DOC-POINTER.
  • Un WORD 0x0000 en tête de l’ID de cible est interdit.

Exemple

CibleSéquence de WORD
LOCAL 5 de l’IMPORT ID 10202 0001 0005
LOCAL 65536 de l’IMPORT ID 10203 0001 0001 0000
LOCAL 5 de l’IMPORT ID 700000253 0001 1170 0005

Pages liées

Texte source du document de spécification

Le document de spécification 0x00000000/codecs/0x00000200/latest.geul tel que le lit geul show (hexadécimal en majuscules).

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

Ce qui précède est le document de Codec de EXTERNAL-POINTER-1WORD-IDENTIFIED (0x020L). Pour les autres membres (EXTERNAL-POINTER-1WORD-GENERIC, EXTERNAL-POINTER-1WORD-FREE-CHOICE, EXTERNAL-POINTER-1WORD-UNIVERSAL, EXTERNAL-POINTER-1WORD-VARIABLE), seuls le Codec ID du DOC-ID, la cible DECLARE et le nom lié (BIND) en #1 diffèrent.