| Параметр | Значение |
|---|---|
| Имя | FRACTION (документ спецификации BIND FRACTION) |
| TAG ID | 0x067L |
| Codec ID | 0x00000670 |
| Документ спецификации | 0x00000000/codecs/0x00000670/ (цель DECLARE 0670) |
| Раздел | 3 0011 (Value), смещение внутри раздела C = 7 |
| Kind | Value · семейство: NUMERIC |
| TAG WORD | 0000 0110 0111 LLLL (000K KKKC CCCC LLLL) |
| Описание индекса | дробь с сохранением исходной записи: числитель — целое или десятичное число, знаменатель — беззнаковое целое или десятичное число. Не сокращается |
| На стороне Hugo | value/numeric/fraction.md |
Поля (документ спецификации)
Порядок FIELD внутри документа — это порядок полей Payload (документ спецификации Codec).
| Порядок | Поле (BIND) | FIELD | Ширина | Принимаемый формат (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | numerator | #2 | запись | 0610 SIGNED-INTEGER, 0680 SIGNED-DECIMAL | |
| 2 | denominator | #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)(у компонента INTEGERE = 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/3 | INTEGER 2 WORD + INTEGER 2 WORD | 5 WORD |
5/100 | INTEGER 2 WORD + INTEGER 2 WORD | 5 WORD |
23.45/1256.1 | DECIMAL 4 WORD + DECIMAL 4 WORD | 9 WORD |
Пример
2/3:
0674 0611 0002 0621 0003
- TAG
0674(Codec0x067L, 5 WORD), numerator0611 0002(SIGNED-INTEGER 2), denominator0621 0003(UNSIGNED-INTEGER 3).
23.45/1256.1:
0678 0683 FFFF FFFE 0929 0693 FFFF FFFF 3111
- TAG
0678(9 WORD), numerator0683 FFFF FFFE 0929(SIGNED-DECIMAL E = -2, C = 2345), denominator0693 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 и 2/3). - Формат, который кладёт дробь с единицами в компонентах (площадь/площадь) в два QUANTITY. FRACTION единицу не хранит.
- Критерий записи процентов и промилле (
5%,5‰): хранить как DECIMAL с единицей или как FRACTION (5/100). - Многоэтажные дроби (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