| Eintrag | Wert |
|---|---|
| Name | SIGNED-INTEGER (Spezifikationsdokument BIND SIGNED-INTEGER) |
| TAG ID | 0x061L |
| Codec ID | 0x00000610 |
| Spezifikationsdokument | 0x00000000/codecs/0x00000610/ (DECLARE-Ziel 0610) |
| Abschnitt | 3 0011 (Value), Offset C im Abschnitt = 1 |
| Kind | Value · Familie: NUMERIC |
| TAG WORD | 0000 0110 0001 LLLL (000K KKKC CCCC LLLL) |
| Index-Beschreibung | vorzeichenbehaftete Ganzzahl im Zweierkomplement mit minimaler WORD-Anzahl |
| Hugo-Seite | value/numeric/signed-integer.md |
Felder (Spezifikationsdokument)
Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).
| Nr. | Feld (BIND) | FIELD | Breite | Zielformat (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | integer | #2 | restlicher Rohwert (0xFFFF) |
SIGNED-INTEGER ist ein Value, der vorzeichenbehaftete Ganzzahlwerte darstellt. Direkter Value-Code 0x061L, Familie NUMERIC. Der gesamte Payload wird als Zweierkomplement-Ganzzahl beliebiger Genauigkeit in big-endian-WORD-Reihenfolge gelesen. Der Payload hat mindestens 1 WORD, und nur die kanonische Darstellung mit minimaler WORD-Anzahl ist zulässig.
Layout
TAG WORD 0000 0110 0001 LLLL Codec 0x061L
[Length-Erweiterungs-TAG] bei insgesamt 15 WORD oder mehr
Payload WORD 1st (oberes WORD) Integer 1st
...
Payload WORD Nth (unteres WORD) Integer Nth
Interpretation
- Das höchstwertige Bit des ersten Payload-WORD ist das Vorzeichenbit der gesamten Ganzzahl.
- Alle Payload-WORD werden als eine zusammenhängende Zweierkomplement-Bitfolge gelesen. Das erste WORD ist die höchste Stelle, das letzte WORD die niedrigste.
- Hat der Payload N WORD, beträgt die Interpretationsbreite
16NBit. Diese Breite ist keine deklarierte Speicherbreite, sondern die Darstellungsbreite des Werts, die sich aus der kanonischen Darstellung ergibt. - Es gibt weder Byte Count noch Bitbreiten-Descriptor.
Kanonische Darstellung
- 0 ist der Payload
0000mit 1 WORD. - Führende Vorzeichenerweiterungs-WORD, die den Wert nicht ändern, sind verboten.
- Bei einem Payload von 2 WORD oder mehr sind folgende Fälle nicht kanonisch.
- Das erste WORD ist
0000und das höchstwertige Bit des nächsten WORD ist 0 - Das erste WORD ist
FFFFund das höchstwertige Bit des nächsten WORD ist 1
- Das erste WORD ist
- Ein führendes
0000, das das Vorzeichen einer positiven Zahl bewahrt, ist zulässig, wenn das höchstwertige Bit des nächsten WORD 1 ist. - Ein führendes
FFFF, das das Vorzeichen einer negativen Zahl bewahrt, ist zulässig, wenn das höchstwertige Bit des nächsten WORD 0 ist. - Ein Decoder muss nicht kanonische Darstellungen ablehnen.
Länge
- Die Gesamtzahl ist die Summe der WORD aus 1 WORD TAG, dem Length-Erweiterungs-TAG (falls vorhanden) und dem Payload. Bis 14 WORD wird die direkte Länge verwendet, ab 15 WORD die erweiterte Länge
1110·1111, und auch der Erweiterungs-TAG zählt zur Gesamtzahl (Record und TAG WORD). - Deklarierte Breiten wie INT8, INT16 und INT32 werden nicht bewahrt, nur der Zahlenwert.
-32768bis32767belegen 1 WORD, außerhalb dieses Bereichs kommen so viele WORD hinzu, wie nötig sind. Ein eigenes Format SIGNED-INT8 gibt es nicht.
Beispiel
| Wert | Payload-WORD | Beurteilung |
|---|---|---|
| 0 | 0000 | kanonisch |
| 1 | 0001 | kanonisch |
| 32767 | 7FFF | kanonisch |
| 32768 | 0000 8000 | kanonisch: 0000 ist nötig, um das positive Vorzeichen zu bewahren |
| -1 | FFFF | kanonisch |
| -32768 | 8000 | kanonisch |
| -32769 | FFFF 7FFF | kanonisch: FFFF ist nötig, um das negative Vorzeichen zu bewahren |
| 1 | 0000 0001 | nicht kanonisch: überflüssiges führendes 0000 |
| -1 | FFFF FFFF | nicht kanonisch: überflüssiges führendes FFFF |
Formatstatus
- Das Zweierkomplement ist eine weit verbreitete Konvention, aber diese Darstellung, die Werte beliebiger Genauigkeit zu einer Folge von WORD mit mindestens 16 Bit normalisiert und mit dem GEUL-TAG verbindet, ist ein GEUL-eigenes Skalarprofil.
- Beim Austausch mit externen Typen fester Breite wie INT8/16/32/64 sind eine Bereichsprüfung und eine explizite Breitenkonvertierung nötig.
Originaltext des Spezifikationsdokuments
Das Spezifikationsdokument 0x00000000/codecs/0x00000610/latest.geul, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).
SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000061000000000
BODY
#1 DECLARE 0x0610
#2 FIELD #1 rest
#3 BIND #1 "SIGNED-INTEGER"
#4 BIND #2 "integer"