ПараметрЗначение
ИмяFRACTION (документ спецификации BIND FRACTION)
TAG ID0x067L
Codec ID0x00000670
Документ спецификации0x00000000/codecs/0x00000670/ (цель DECLARE 0670)
Раздел3 0011 (Value), смещение внутри раздела C = 7
KindValue · семейство: NUMERIC
TAG WORD0000 0110 0111 LLLL (000K KKKC CCCC LLLL)
Описание индексадробь с сохранением исходной записи: числитель — целое или десятичное число, знаменатель — беззнаковое целое или десятичное число. Не сокращается
На стороне Hugovalue/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. Дробь не сокращается. Хранятся дроби, для которых запись в исходном виде и есть сама запись данных: например, «две трети» и «пять сотых» в законах или десятичная доля 23.45/1256.1 в реестре прав.

Раскладка

TAG WORD          0000 0110 0111 LLLL      Codec 0x067L
[Length-расширяющий TAG] если всего 15 WORD и более
numerator         одна запись Value: SIGNED-INTEGER или SIGNED-DECIMAL
denominator       одна запись Value: 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. Запись компонента как DECIMAL с экспонентой E = 0 — invalid. Поэтому одной и той же записи соответствует одна последовательность байтов.
  • C и E компонента DECIMAL — это число разрядов исходной записи как есть. 23.450 — это 23450×10^-3, и это Value, отличное от 23.45.
  • Дробь не сокращается. 2/4 и «пять сотых» (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 имеют одно значение и разные байты.
  • Проверка кворума («не менее двух третей голосов присутствующих акционеров») выполняется сравнением по этому точному значению.

Длина

  • Общая длина — TAG 1 WORD + (Length-расширяющий TAG) + две записи. Запись целого — TAG 1 + Payload от 1 WORD, запись десятичного числа — 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).

Отношение к другим форматам

  • amount·lower·upper в QUANTITY принимают FRACTION. «Две трети голосов присутствующих» можно записать как QUANTITY без единицы с amount 2/3.
  • Документ спецификации 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