항목값
이름FRACTION (규격 문서 BIND FRACTION)
TAG ID0x067L
코덱 ID0x00000670
규격 문서0x00000000/codecs/0x00000670/ (DECLARE 대상 0670)
섹션3 0011 (Value), 섹션 안 오프셋 C = 7
KindValue · 계열: NUMERIC
TAG WORD0000 0110 0111 LLLL (000K KKKC CCCC LLLL)
색인 설명원문 표기를 보존하는 분수: 정수·10진수 분자, 부호 없는 정수·10진수 분모. 약분하지 않음
Hugo 쪽value/numeric/fraction.md

필드 (규격 문서)

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

순서필드(BIND)FIELD폭받는 형식(CODEC)ENUM
1numerator#2레코드0610 SIGNED-INTEGER, 0680 SIGNED-DECIMAL
2denominator#3레코드0620 UNSIGNED-INTEGER, 0690 UNSIGNED-DECIMAL

FRACTION은 원문에 적힌 분수를 표기 그대로 나타내는 Value다. Value 직접 코드 0x067L, 계열 NUMERIC이다. 분자와 분모는 각각 완전한 Value 레코드다. 약분하지 않는다. 법령의 “3분의 2”, “100분의 5"와 등기의 소수 지분 23.45/1256.1처럼 적힌 그대로가 기록인 분수를 담는다.

레이아웃

TAG WORD          0000 0110 0111 LLLL      Codec 0x067L
[Length 확장 TAG] 전체 15 WORD 이상일 때
numerator         Value 레코드 1개: SIGNED-INTEGER 또는 SIGNED-DECIMAL
denominator       Value 레코드 1개: UNSIGNED-INTEGER 또는 UNSIGNED-DECIMAL

해석과 유효성

  • numerator는 SIGNED-INTEGER(0x061L) 또는 SIGNED-DECIMAL(0x068L) 레코드 정확히 하나다.
  • denominator는 UNSIGNED-INTEGER(0x062L) 또는 UNSIGNED-DECIMAL(0x069L) 레코드 정확히 하나다.
  • 닫힌 목록이다. 그 밖의 Value, FRACTION 자신(중첩 금지), 자리 표지(0x0000 등)는 받지 않는다.
  • 두 레코드는 각자 길이를 가지므로 경계를 따로 적지 않는다. 두 레코드를 읽은 커서는 Payload 끝과 정확히 맞아야 한다.
  • 안쪽 레코드도 각 Codec의 정규형을 따른다(정수·coefficient는 최소 WORD). 비정규 안쪽 레코드가 있으면 FRACTION 전체가 invalid다.
  • 값은 numerator / denominator다.

표기 보존

  • 정수와 소수: 원문 성분이 정수(소수점 없음)이면 INTEGER 레코드, 소수점이 있으면 DECIMAL 레코드를 쓴다. 성분을 지수 E = 0인 DECIMAL로 쓰면 invalid다. 그래서 같은 표기는 바이트열이 하나다.
  • DECIMAL 성분의 C와 E는 원문 자릿수 그대로다. 23.450은 23450×10^-3이고 23.45와 다른 Value다.
  • 약분하지 않는다. 2/4, “100분의 5”(5/100)는 그대로 쓴다. 바이트가 같으면 원문 표기가 같다.
  • 분모가 1인 분수(3/1)도 원문이 그렇게 적었으면 그대로 쓴다. 원문이 정수면 FRACTION이 아니라 정수 Codec을 쓴다. 원문이 소수(0.5, 5%)면 DECIMAL을 쓴다.
  • 부호는 분자에만 둔다. 분모는 부호 없는 Codec이다.
  • 분모의 값이 0이면 invalid다(0, 0.0 모두).

비교

  • 비교 계층은 FRACTION을 정확한 유리수 (C1 × 10^E1) / (C2 × 10^E2)로 계산한다(INTEGER 성분은 E = 0). 부동소수로 근사하지 않는다.
  • 비교·정렬·중복 판정은 이 값으로 하고, 저장·서명·내용 해시는 표기(바이트)로 한다. 2/4, 1/2, 0.5는 값이 같고 바이트가 다르다.
  • 정족수 판정(“출석한 주주의 의결권의 3분의 2 이상”)은 이 정확한 값으로 비교한다.

길이

  • 전체는 TAG 1 WORD + (Length 확장 TAG) + 두 레코드다. 정수 레코드는 TAG 1 + Payload 1 WORD 이상, 10진수 레코드는 TAG 1 + 지수 2 + coefficient 1 WORD 이상이다.
  • 작은 정수 분수는 5 WORD, 작은 소수 분수는 9 WORD다. 15 WORD 이상이면 확장 길이를 쓴다(레코드와 TAG WORD).
원문성분전체
2/3INTEGER 2 WORD + INTEGER 2 WORD5 WORD
5/100INTEGER 2 WORD + INTEGER 2 WORD5 WORD
23.45/1256.1DECIMAL 4 WORD + DECIMAL 4 WORD9 WORD

예시

2/3:

0674 0611 0002 0621 0003
  • TAG 0674(Codec 0x067L, 5 WORD), numerator 0611 0002(SIGNED-INTEGER 2), denominator 0621 0003(UNSIGNED-INTEGER 3).

23.45/1256.1:

0678 0683 FFFF FFFE 0929 0693 FFFF FFFF 3111
  • TAG 0678(9 WORD), numerator 0683 FFFF FFFE 0929(SIGNED-DECIMAL E = -2, C = 2345), denominator 0693 FFFF FFFF 3111(UNSIGNED-DECIMAL E = -1, C = 12561).

다른 형식과의 관계

  • QUANTITY의 amount·lower·upper는 FRACTION을 받는다. “출석 의결권의 3분의 2"는 amount 2/3, 무단위 QUANTITY로 쓸 수 있다.
  • geul.org 규격 문서 0x00000000/codecs/0x00000670은 numerator(0610·0680), denominator(0620·0690)의 레코드 필드 둘로 적는다(Codec 규격 문서).
  • 약분을 강제하는 고정 int64 분수가 필요하면 Issuer 형식 RATIONAL-I64를 쓴다.

열린 문제

  1. 대분수(1과 2/3)의 표기 보존.
  2. 성분에 단위가 있는 분수(면적/면적)를 QUANTITY 둘로 담는 형식. FRACTION은 단위를 담지 않는다.
  3. 백분율·퍼밀(5%, 5‰)을 DECIMAL과 단위로 둘지, FRACTION(5/100)으로 둘지의 표기 기준.
  4. 번분수(분자·분모에 FRACTION). 지금은 금지한다.

관련 페이지

규격 문서 원문

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

SPEC-VERSION 0x0001
DOC-ID 0x0426000000000000067000000000
BODY
#1 DECLARE 0x0670
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "FRACTION"
#5 BIND #2 "numerator"
#6 BIND #3 "denominator"
#7 CODEC #2 0x0610
#8 CODEC #2 0x0680
#9 CODEC #3 0x0620
#10 CODEC #3 0x0690