EintragWert
NameFRACTION (Spezifikationsdokument BIND FRACTION)
TAG ID0x067L
Codec ID0x00000670
Spezifikationsdokument0x00000000/codecs/0x00000670/ (DECLARE-Ziel 0670)
Abschnitt3 0011 (Value), Offset C im Abschnitt = 7
KindValue · Familie: NUMERIC
TAG WORD0000 0110 0111 LLLL (000K KKKC CCCC LLLL)
Index-BeschreibungBruch in der Originalschreibweise: Zähler als Ganzzahl oder Dezimalzahl, Nenner als vorzeichenlose Ganzzahl oder Dezimalzahl. Wird nicht gekürzt
Hugo-Seitevalue/numeric/fraction.md

Felder (Spezifikationsdokument)

Die Reihenfolge der FIELD im Dokument ist die Reihenfolge der Payload-Felder (Codec-Spezifikationsdokument).

Nr.Feld (BIND)FIELDBreiteZielformat (CODEC)ENUM
1numerator#2Record0610 SIGNED-INTEGER, 0680 SIGNED-DECIMAL
2denominator#3Record0620 UNSIGNED-INTEGER, 0690 UNSIGNED-DECIMAL

FRACTION ist ein Value, der einen im Originaltext angegebenen Bruch in seiner ursprünglichen Schreibweise darstellt. Direkter Value-Code 0x067L, Familie NUMERIC. Zähler und Nenner sind jeweils vollständige Value-Records. Es wird nicht gekürzt. Aufgenommen werden Brüche, bei denen die Schreibweise selbst der Datensatz ist, etwa „zwei Drittel“ oder „fünf Hundertstel“ in Gesetzen und der Dezimalanteil 23.45/1256.1 in Grundbucheinträgen.

Layout

TAG WORD          0000 0110 0111 LLLL      Codec 0x067L
[Length-Erweiterungs-TAG] bei insgesamt 15 WORD oder mehr
numerator         1 Value-Record: SIGNED-INTEGER oder SIGNED-DECIMAL
denominator       1 Value-Record: UNSIGNED-INTEGER oder UNSIGNED-DECIMAL

Interpretation und Gültigkeit

  • numerator ist genau ein SIGNED-INTEGER- (0x061L) oder SIGNED-DECIMAL-Record (0x068L).
  • denominator ist genau ein UNSIGNED-INTEGER- (0x062L) oder UNSIGNED-DECIMAL-Record (0x069L).
  • Die Liste ist geschlossen. Andere Value, FRACTION selbst (Verschachtelung verboten) und Slot-Marker (0x0000 usw.) werden nicht akzeptiert.
  • Die beiden Records haben jeweils eigene Längen, daher wird keine Grenze gesondert angegeben. Der Cursor nach dem Lesen der beiden Records muss genau mit dem Ende des Payload übereinstimmen.
  • Auch innere Records folgen der kanonischen Form ihres jeweiligen Codec (Ganzzahl und coefficient mit minimaler WORD-Anzahl). Gibt es einen nicht kanonischen inneren Record, ist das gesamte FRACTION invalid.
  • Der Wert ist numerator / denominator.

Bewahrung der Schreibweise

  • Ganzzahl und Dezimalzahl: Ist die Komponente im Original eine Ganzzahl (ohne Dezimalpunkt), wird ein INTEGER-Record verwendet, mit Dezimalpunkt ein DECIMAL-Record. Eine Komponente als DECIMAL mit Exponent E = 0 zu schreiben ist invalid. So hat dieselbe Schreibweise genau eine Bytefolge.
  • C und E einer DECIMAL-Komponente entsprechen der Stellenzahl des Originals. 23.450 ist 23450×10^-3 und ein anderer Value als 23.45.
  • Es wird nicht gekürzt. 2/4 und „fünf Hundertstel“ (5/100) werden unverändert geschrieben. Gleiche Bytes bedeuten gleiche Originalschreibweise.
  • Auch ein Bruch mit Nenner 1 (3/1) wird so geschrieben, wenn das Original ihn so angibt. Ist das Original eine Ganzzahl, wird nicht FRACTION, sondern ein Ganzzahl-Codec verwendet. Ist das Original eine Dezimalzahl (0.5, 5%), wird DECIMAL verwendet.
  • Das Vorzeichen steht nur im Zähler. Der Nenner ist ein vorzeichenloser Codec.
  • Ist der Wert des Nenners 0, ist es invalid (sowohl 0 als auch 0.0).

Vergleich

  • Die Vergleichsschicht berechnet FRACTION als exakte rationale Zahl (C1 × 10^E1) / (C2 × 10^E2) (INTEGER-Komponenten mit E = 0). Es wird nicht durch Gleitkomma angenähert.
  • Vergleich, Sortierung und Duplikaterkennung erfolgen mit diesem Wert, Speicherung, Signatur und Inhaltshash mit der Schreibweise (den Bytes). 2/4, 1/2 und 0.5 haben denselben Wert und unterschiedliche Bytes.
  • Die Beschlussfähigkeitsprüfung („mindestens zwei Drittel der Stimmrechte der anwesenden Aktionäre“) vergleicht mit diesem exakten Wert.

Länge

  • Die Gesamtzahl ist 1 WORD TAG + (Length-Erweiterungs-TAG) + zwei Records. Ein Ganzzahl-Record hat TAG 1 + Payload ab 1 WORD, ein Dezimal-Record TAG 1 + Exponent 2 + coefficient ab 1 WORD.
  • Ein Bruch aus kleinen Ganzzahlen hat 5 WORD, ein Bruch aus kleinen Dezimalzahlen 9 WORD. Ab 15 WORD wird die erweiterte Länge verwendet (Record und TAG WORD).
OriginalKomponentenGesamt
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

Beispiel

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).

Beziehung zu anderen Formaten

  • amount, lower und upper von QUANTITY akzeptieren FRACTION. „Zwei Drittel der Stimmrechte der anwesenden Aktionäre“ lässt sich als QUANTITY ohne Einheit mit amount 2/3 schreiben.
  • Das geul.org-Spezifikationsdokument 0x00000000/codecs/0x00000670 schreibt zwei Record-Felder: numerator (0610, 0680) und denominator (0620, 0690) (Codec-Spezifikationsdokument).
  • Wird ein Bruch mit fester int64-Breite benötigt, der das Kürzen erzwingt, wird das Issuer-Format RATIONAL-I64 verwendet.

Offene Probleme

  1. Bewahrung der Schreibweise gemischter Brüche (1 und 2/3).
  2. Ein Format, das einen Bruch mit Einheiten in den Komponenten (Fläche/Fläche) in zwei QUANTITY aufnimmt. FRACTION nimmt keine Einheiten auf.
  3. Das Schreibkriterium, ob Prozent und Promille (5%, 5‰) als DECIMAL mit Einheit oder als FRACTION (5/100) gelten.
  4. Doppelbrüche (FRACTION in Zähler und Nenner). Sie sind derzeit verboten.

Verwandte Seiten

Originaltext des Spezifikationsdokuments

Das Spezifikationsdokument 0x00000000/codecs/0x00000670/latest.geul, gelesen mit geul show (Hexadezimalwerte in Großbuchstaben).

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