EXTERNAL-POINTER ist ein zeigendes Reference auf eine LOCAL ID eines Dokuments, das mit IMPORT-DOC im HEAD importiert wurde.

EintragWert
NameEXTERNAL-POINTER-4WORD (5Q-Gruppe. Namen der einzelnen Codes in der Mitgliedertabelle unten)
TAG ID0x02AL~0x02EL
Abschnitt1 0001 (Reference EXTERNAL), Offset im Abschnitt C = 10~14
KindReference · Klasse: Zeigen
Hugo-Seitereference/external-pointer.md (diese Seite behandelt auch EXTERNAL-POINTER-1WORD und EXTERNAL-POINTER-2WORD)

Mitglieder

Diese Seite behandelt ein vollständiges 5Q-System, also fünf Codes zusammen. Die Quantifizierung ist der Offset im Abschnitt C % 5 (Reference). Es gibt ein Codec-Dokument pro Code. Die Felder der fünf Codec-Dokumente sind gleich, nur DECLARE-Ziel und Name (BIND) unterscheiden sich.

TAG IDNameQuantifizierungCodec IDSpezifikationsdokumentTAG 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

Felder (Spezifikationsdokument)

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

ReihenfolgeFeld (BIND)FIELDBreiteAkzeptiertes Format (CODEC)ENUM
1import-id#2Rohwert 4 WORD
2target-id#3restlicher Rohwert (0xFFFF)

EXTERNAL-POINTER ist ein zeigendes Reference auf eine LOCAL ID eines Dokuments, das mit IMPORT-DOC im HEAD importiert wurde.

Layout

TAG WORD          0000 001C CCCC LLLL      Codec 0x020L~0x02EL (Abschnitt 1)
[Length-Erweiterungs-TAG]
IMPORT ID         vom Codec bestimmte Breite (1/2/4 WORD)
Ziel-ID           der gesamte Rest. LOCAL ID des importierten Dokuments, kürzeste Breite
Codec (Identified, Generic, Free-choice, Universal, Variable)NameBreite der IMPORT ID
0x020L~0x024LEXTERNAL-POINTER-1WORD1 WORD
0x025L~0x029LEXTERNAL-POINTER-2WORD2 WORD
0x02AL~0x02ELEXTERNAL-POINTER-4WORD4 WORD
  • Die Breite wird durch die Systemnummer bestimmt: Ist Systemnummer − 6 (C / 5 des Offsets im Abschnitt C) gleich 0, 1 oder 2, beträgt sie 1, 2 bzw. 4 WORD. Die Quantifizierung ist C % 5.

  • Es wird der schmalste Codec verwendet, in den der Wert der IMPORT ID passt.

  • Die IMPORT ID ist der Wert, den das IMPORT-DOC dieses Dokuments vergeben hat. Im EXTERNAL-POINTER wird kein Issuer angegeben. Issuer und Dokument-ID erhält man aus diesem IMPORT-DOC. Auch die Version bestimmt dieses IMPORT-DOC (fest oder neueste).

  • Ist es dieselbe LOCAL ID des importierten Dokuments, bezeichnet sie dasselbe Objekt, ob sie dort als LOCAL oder hier als EXTERNAL-POINTER geschrieben wird.

  • Bei Variable ist es eine LOCAL-Variable des importierten Dokuments.

Gültigkeit

  • Gibt es in diesem Dokument kein IMPORT-DOC, das diese IMPORT ID vergeben hat, ist es invalid.
  • Passt die IMPORT ID in einen schmaleren Codec und wird ein breiterer verwendet, wird es als non-minimal abgelehnt.
  • Ist die Ziel-ID 0, ist es invalid. Auf das importierte Dokument selbst verweist man mit DOC-POINTER.
  • Führende WORD 0x0000 in der Ziel-ID sind verboten.

Beispiel

ZielWORD sequence
IMPORT ID 1, LOCAL 50202 0001 0005
IMPORT ID 1, LOCAL 655360203 0001 0001 0000
IMPORT ID 70000, LOCAL 50253 0001 1170 0005

Verwandte Seiten

Originaltext des Spezifikationsdokuments

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

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"

Oben steht das Codec-Dokument von EXTERNAL-POINTER-4WORD-IDENTIFIED (0x02AL). Die Codec-Dokumente der anderen Mitglieder (EXTERNAL-POINTER-4WORD-GENERIC, EXTERNAL-POINTER-4WORD-FREE-CHOICE, EXTERNAL-POINTER-4WORD-UNIVERSAL, EXTERNAL-POINTER-4WORD-VARIABLE) unterscheiden sich nur in der Codec ID der DOC-ID, im DECLARE-Ziel und im in #1 gebundenen Namen (BIND).