ItemValue
NameUNSIGNED-INTEGER (spec document BIND UNSIGNED-INTEGER)
TAG ID0x062L
Codec ID0x00000620
Spec document0x00000000/codecs/0x00000620/ (DECLARE target 0620)
Section3 0011 (Value), offset C within the section = 2
KindValue · family: NUMERIC
TAG WORD0000 0110 0010 LLLL (000K KKKC CCCC LLLL)
Index descriptionMinimum-WORD big-endian unsigned magnitude integer
Hugo sidevalue/numeric/unsigned-integer.md

Fields (spec document)

The order of FIELDs in the document is the order of the Payload fields (Codec spec document).

OrderField (BIND)FIELDWidthReceiving format (CODEC)ENUM
1magnitude#2remaining raw value (0xFFFF)

UNSIGNED-INTEGER is a Value that represents an unsigned integer. Its direct Value code is 0x062L, family NUMERIC. The whole Payload is read as an arbitrary-precision unsigned magnitude in big-endian WORD order. The Payload is at least 1 WORD, and only the minimum-WORD canonical representation is allowed.

Layout

TAG WORD          0000 0110 0010 LLLL      Codec 0x062L
[Length extension TAG] when the total is 15 WORD or more
Payload WORD 1st  (high WORD)   Unsigned Magnitude 1st
...
Payload WORD Nth  (low WORD)    Unsigned Magnitude Nth

Interpretation

  • The first Payload WORD is the highest place and the last WORD is the lowest.
  • If the Payload is N WORD, it is read as a single 16N bit unsigned magnitude.
  • This width is not a declared storage width, and there is no bit width descriptor.

Canonical form

  • 0 is the 1 WORD Payload 0000.
  • When the Payload is 2 WORD or more and the first WORD is 0000, the representation is non-canonical because removing it leaves the value unchanged.
  • A decoder must reject a representation with an unnecessary leading zero WORD.

Length

  • The total is the WORD count of the TAG 1 WORD, the Length extension TAG (if any), and the Payload. Up to 14 WORD uses the direct length, and 15 WORD or more uses the 1110/1111 extended length; the extension TAG is also counted in the total (Record and TAG WORD).
  • A declared width such as UINT8, UINT16, or UINT32 is not preserved; only the numeric value is.

Examples

ValuePayload WORDVerdict
00000canonical
10001canonical
65535FFFFcanonical
655360001 0000canonical
10000 0001non-canonical: unnecessary leading 0000
7 WORD Payload7 WORD after TAG 0627 (direct length LLLL=0111, total 8 WORD)canonical
7 WORD Payload7 WORD after a Length extension TAG with extension value 0009non-canonical: up to 14 WORD must use the direct length

Format status

  • This representation, which normalizes an arbitrary-precision unsigned magnitude into a sequence of minimum 16-bit WORDs and binds it to a GEUL TAG, is a GEUL-specific scalar profile.
  • Exchanging values with fixed-width external types such as UINT8/16/32/64 requires a range check and an explicit width conversion.

Spec document source

This is the spec document 0x00000000/codecs/0x00000620/latest.geul as read with geul show (hexadecimal in uppercase).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000062000000000
BODY
#1 DECLARE 0x0620
#2 FIELD #1 rest
#3 BIND #1 "UNSIGNED-INTEGER"
#4 BIND #2 "magnitude"