| Élément | Valeur |
|---|---|
| Nom | DOC-POINTER (BIND DOC-POINTER du document de spécification) |
| TAG ID | 0x041L |
| Codec ID | 0x00000410 |
| Document de spécification | 0x00000000/codecs/0x00000410/ (cible DECLARE 0410) |
| Section | 2 0010 (Reference divers), offset dans la section C = 1 |
| Kind | Reference · classification : désignation-déclaration |
| TAG WORD | 0000 0100 0001 LLLL (000K KKKC CCCC LLLL) |
| Côté Hugo | reference/doc-pointer.md |
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).
| Ordre | Champ (BIND) | FIELD | Largeur | Format accepté (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | issuer | #2 | valeur brute restante (0xFFFF) | ||
| 2 | doc | #3 | valeur brute 4 WORD | ||
| 3 | version | #4 | valeur brute 2 WORD |
DOC-POINTER est une Reference de désignation-déclaration qui désigne une version d’un document publié par un Issuer. Il devient la cible de la publication, de la deprecation et de la suppression d’un document, de la version citée, et des énoncés portant sur le document.
Disposition
TAG WORD 0000 0100 0001 LLLL Codec 0x041L
[TAG d'extension de Length]
Issuer 2/4/16 WORD
ID de document 4 WORD
ID de version 2 WORD
Interprétation et validité
- La largeur de l’Issuer est ce qui reste du Payload une fois retirés les 6 WORD de l’ID de document et de l’ID de version. Le Codec ne la subdivise pas. Si la largeur n’est pas de 2, 4 ou 16 WORD, ou si la valeur de l’Issuer tient dans une largeur plus étroite, c’est invalid (forme canonique de l’Issuer).
- L’ID de version n’est pas omis. Si l’on autorisait l’omission, la longueur du Payload seule ne suffirait pas à déterminer la largeur de l’Issuer (Issuer de 4 WORD sans version et Issuer de 2 WORD avec version feraient tous deux 8 WORD).
- L’ID de version
0est la version la plus récente. Il est lié à la version en vigueur au moment de l’interprétation. Les autres valeurs sont fixées à cette version (PUBLICATION). - L’ID de document
0est le document d’index des définitions de termes de l’Issuer. L’Issuer lui-même se désigne par ISSUER-POINTER. - Tout Issuer réserve les ID de document
0x0000000000000000et0xFFFFFFFFFFFFFFFF(Issuer et publication).0xFFFFFFFFFFFFFFFFsert à la liste des Issuerissuers/de l’Issuer0x00000000, et les autres Issuer ne l’emploient pas. PUBLICATION, DEPRECATION et TOMBSTONE deissuers/versions.geuldésignent par cette valeur les versions de la liste (adresse de publication et liste des versions). - C’est une seule place de Codec,
0x041L. Il n’y a pas de quantification (Identified). - La forme qui désigne un document d’un Issuer est DOC-POINTER, et seulement lui. Désigner un document par
EXTERNAL-ISSUER-*(Issuer, ID de document, ID de cible0) ou parEXTERNAL-POINTER-*(IMPORT ID, ID de cible0) est invalid. - Emplois : Meta DOC-ID et IMPORT-DOC, PUBLICATION, DEPRECATION et TOMBSTONE de la liste des versions.
- Un document de Codec n’a pas d’ID de document. Un document de Codec et ses versions se désignent par CODEC-POINTER.
Exemple
Le document 0xFFFF000000000001 de l’Issuer GEUL 0x00000000.
| Version | Séquence de WORD |
|---|---|
| 1 | 0418 0000 0000 FFFF 0000 0000 0001 0000 0001 |
la plus récente (0) | 0418 0000 0000 FFFF 0000 0000 0001 0000 0000 |
- TAG 1 + Issuer 2 + ID de document 4 + ID de version 2 = 9 WORD,
LLLL=1000. Le TAG est0000 0100 0001 1000=0418.
Pages liées
Texte source du document de spécification
Le document de spécification 0x00000000/codecs/0x00000410/latest.geul tel que le lit geul show (hexadécimal en majuscules).
SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000041000000000
BODY
#1 DECLARE 0x0410
#2 FIELD #1 rest
#3 FIELD #1 0x0004
#4 FIELD #1 0x0002
#5 BIND #1 "DOC-POINTER"
#6 BIND #2 "issuer"
#7 BIND #3 "doc"
#8 BIND #4 "version"