항목값
이름UNSIGNED-DECIMAL (규격 문서 BIND UNSIGNED-DECIMAL)
TAG ID0x069L
코덱 ID0x00000690
규격 문서0x00000000/codecs/0x00000690/ (DECLARE 대상 0690)
섹션3 0011 (Value), 섹션 안 오프셋 C = 9
KindValue · 계열: DECIMAL
TAG WORD0000 0110 1001 LLLL (000K KKKC CCCC LLLL)
색인 설명signed exponent E와 최소 WORD unsigned coefficient C의 C×10^E
Hugo 쪽value/decimal/unsigned-decimal.md

필드 (규격 문서)

FIELD의 문서 안 순서가 Payload 필드 순서다(Codec 규격 문서).

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1exponent#2날값 2 WORD
2coefficient#3나머지 날값(0xFFFF)

UNSIGNED-DECIMAL은 부호 없는 coefficient를 가진 정확한 10진수(exact decimal) Value다. Value 직접 코드 0x069L, 계열 DECIMAL이다. Payload 첫 2 WORD는 signed 32bit 10진 exponent E, 나머지는 최소 WORD unsigned coefficient C이며 값은 C×10^E다.

레이아웃

TAG WORD          0000 0110 1001 LLLL      Codec 0x069L
[Length 확장 TAG] 전체 15 WORD 이상일 때
Payload WORD 1st–2nd (32비트)       Signed Base-10 Exponent E
Payload WORD 3rd–Nth (1 WORD 이상)  Unsigned Coefficient C

해석

  • E는 상위 WORD부터 기록한 signed 32bit big-endian 2의 보수 정수다.
  • C는 나머지 WORD 전체를 상위 WORD부터 읽은 임의 정밀도 unsigned magnitude다.
  • C는 UNSIGNED-INTEGER와 같은 최소 WORD 규칙을 따른다. 0은 0000이며, 2 WORD 이상에서 첫 WORD 0000은 금지한다.

길이와 유효성

  • 전체는 TAG 1 WORD, Length 확장 TAG(있으면), Payload를 합한 WORD 수다. 14 WORD 이하는 직접 길이, 15 WORD 이상은 1110·1111 확장 길이를 쓰며 확장 TAG도 전체 수에 들어간다(레코드와 TAG WORD).
  • Payload는 exponent 2 WORD와 coefficient 1 WORD 이상이므로 최소 3 WORD다.
  • 바이트 표현의 정규성은 coefficient의 최소 WORD 표현만 검사한다.

예시

값 표현Payload (E + C)판정
1×10^00000 0000 0001바이트 표현 정규
10×10^-1FFFF FFFF 000A바이트 표현 정규, 위 표현과의 canonical 관계는 열린 문제
1×10^00000 0000 0000 0001비정규: coefficient 선행 0000 불필요
음수 coefficient해당 없음invalid

형식 지위

  • signed 32비트 exponent E와 unsigned 최소 WORD coefficient C를 묶은 이 배치는 IEEE 754 decimal interchange나 Apache Parquet DECIMAL이 아닌 GEUL 고유 형식이다.
  • Parquet DECIMAL은 signed unscaled value, unscaledValue × 10^(-scale), 필수 precision/scale metadata를 쓰고, byte-array 물리형은 big-endian 2의 보수이며 scale은 0 이상이다. 이 형식은 unsigned C, signed E, precision metadata 부재 때문에 같은 형식이 아니다.
  • IEEE 754 decimal이나 Parquet DECIMAL과 주고받으려면 부호, 범위, precision/scale, quantum, 특수값 정책을 정한 명시적 변환이 필요하다.
  • 비교 근거: IEEE 754-2019, Apache Parquet Logical Types — DECIMAL

열린 문제

  • 10×10^-1과 1×10^0처럼 같은 수를 나타내는 exponent/coefficient 쌍이 여럿 있다.
  • 이 형식이 quantum을 보존하는지, 값 동등성을 어떻게 판정하는지, canonical exponent를 어떻게 정규화하는지는 아직 정하지 않았다.
  • 그래서 구현은 coefficient 최소 WORD 규칙 밖의 exponent/coefficient 정규화를 임의로 강제해서는 안 된다.

규격 문서 원문

규격 문서 0x00000000/codecs/0x00000690/latest.geul을 geul show로 읽은 모습이다(16진은 대문자).

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000069000000000
BODY
#1 DECLARE 0x0690
#2 FIELD #1 0x0002
#3 FIELD #1 rest
#4 BIND #1 "UNSIGNED-DECIMAL"
#5 BIND #2 "exponent"
#6 BIND #3 "coefficient"