Softanza
DémarrerEnglish
Softanza
DémarrerEnglish
Référence · stzNumber

Representation()

Promotion is automatic and upward only: adding 1 to a 2^53 integer yields a :bigInteger, and nothing silently demotes. :rational and :complex are named in the plan and not built yet, so they are not reported -- a ladder that claims rungs it does not have is worse than a short one.

aussi: which representation what kind of number integer or decimal

Exemples de base (2)

Softanza
oS = StzNumberQ("0.1")
oS.Add("0.2")
? oS.Content()
? oS.IsExact()
? oS.Representation()
Sortie
0.3
1
decimal

exécuté le 2026-10-02 04:25 dans la bibliothèque au commit 0e72e2e2c ; tiré de 07-a-number-that-says-why.en.md(s'ouvre dans un nouvel onglet)

Softanza
oB = StzNumberQ("9007199254740993")
? oB.Representation()
oB.Add(1)
? oB.Content()
? 9007199254740993 + 1
Sortie
biginteger
9007199254740994
9007199254740992.00

exécuté le 2026-10-02 04:25 dans la bibliothèque au commit 0e72e2e2c ; tiré de 07-a-number-that-says-why.en.md(s'ouvre dans un nouvel onglet)

Portée (5)

Softanza
oQ = StzNumberQ("1/3")
? oQ.Representation()
? oQ.IsExact()
oQ.Add("2/3")
? oQ.Content()
? oQ.Same(1)
Sortie
rational
1
1
1

exécuté le 2026-10-02 04:25 dans la bibliothèque au commit 0e72e2e2c ; tiré de 07-a-number-that-says-why.en.md(s'ouvre dans un nouvel onglet)

Softanza
oMix = new stzNumber("1/4")
oMix.Add("0.25")
# a quarter plus 0.25 is a half
? oMix.Content()
# ...as a fraction, not 0.5
? oMix.Representation()
# ...and exactly
? oMix.IsExact()
# ...which is what lets a third survive meeting a decimal
? (new stzNumber("1/3")).AddQ("0.5").Content()
Sortie
1/2
rational
1
5/6

exécuté le 2026-10-02 04:23 dans la bibliothèque au commit 0e72e2e2c ; tiré de numeric_rationals_narrated.ring(s'ouvre dans un nouvel onglet)

Softanza
oBig = new stzNumber("1/99999999999999999999999999999999")
# a 32-digit denominator survives construction
? oBig.Content()
# ...and reports as a fraction
? oBig.Representation()
oSum = new stzNumber("1/99999999999999999999999999999999")
oSum.Add("1/99999999999999999999999999999999")
# adding it to itself doubles the numerator
? oSum.Content()
# ...exactly
? oSum.IsExact()
# a fraction that reduces from big parts still lands on the small answer
? (new stzNumber("123456789012345678901234567890/246913578024691357802469135780")).Content()
Sortie
1/99999999999999999999999999999999
rational
2/99999999999999999999999999999999
1
1/2

exécuté le 2026-10-02 04:23 dans la bibliothèque au commit 0e72e2e2c ; tiré de numeric_rationals_narrated.ring(s'ouvre dans un nouvel onglet)

Softanza
# a third is itself
? (new stzNumber("1/3")).Content()
# two quarters reduce
? (new stzNumber("2/4")).Content()
# six thirds reduce past being a fraction at all
? (new stzNumber("6/3")).Content()
# ...and report themselves as an integer
? (new stzNumber("4/2")).Representation()
# a zero numerator is just zero
? (new stzNumber("0/5")).Content()
# the sign lives on the numerator
? (new stzNumber("-1/2")).Content()
# ...even when it was written on the denominator
? (new stzNumber("1/-2")).Content()
# a fraction knows what it is
? (new stzNumber("1/3")).Representation()
# ...and answers the predicate
? (new stzNumber("1/3")).IsRational()
# while a decimal does not
? (new stzNumber("0.5")).IsRational()
Sortie
1/3
1/2
2
integer
0
-1/2
-1/2
rational
1
0

exécuté le 2026-10-02 04:23 dans la bibliothèque au commit 0e72e2e2c ; tiré de numeric_rationals_narrated.ring(s'ouvre dans un nouvel onglet)

Softanza
# a small whole number
? (new stzNumber("42")).Representation()
# ...negative too
? (new stzNumber("-7")).Representation()
# a whole number past what an f64 holds exactly
? (new stzNumber("9007199254740992")).Representation()
# ...and far past it
? (new stzNumber("99999999999999999999999999999999")).Representation()
# a value with a fractional part
? (new stzNumber("19.99")).Representation()
# the predicates read the same
? (new stzNumber("99999999999999999999")).IsBigInteger()
# ...and say no when they should
? (new stzNumber("42")).IsBigInteger()
# ...for decimals
? (new stzNumber("0.5")).IsDecimalNumber()
oGrow = new stzNumber("9007199254740992")
oGrow.Add(1)
# it is still exact
? oGrow.Content()
# ...and reports the bigger rung
? oGrow.Representation()
Sortie
integer
integer
biginteger
biginteger
decimal
1
0
1
9007199254740993
biginteger

exécuté le 2026-10-02 04:23 dans la bibliothèque au commit 0e72e2e2c ; tiré de numeric_no_loss_narrated.ring(s'ouvre dans un nouvel onglet)

Les extensions de cette méthode

Chaque extension, et si elle existe pour cette méthode ; une extension qui existe se compose avec les autres (FindSTCS).

Extension
Existe
Ce qu'elle ajoute · Les noms
Q
non
fait ce que fait la méthode, puis rend l'objet, pour que l'appel puisse s'enchaîner
QQ
non
enchaîne sur le type d'objet suivant, plus précis (l'échelle des Q)
QQQ
non
enchaîne sur le type d'objet le plus précis (l'échelle des Q)
QRT
non
rend le résultat comme un objet du type demandé
CS
non
prend un indicateur de sensibilité à la casse
ST
non
prend la position de départ (StartingAt)
IB
non
prend des bornes incluses (IncludingBounds)
XT
non
la forme étendue : plus de paramètres que la méthode de base
XTT
non
encore une extension : une forme étendue de plus, après XT
Z
non
inclut la position dans ce qu'elle rend
ZZ
non
rend les positions comme des sections, [début, fin]
W
non
choisit selon une condition
WF
non
choisit selon une condition, avec les mots-clés expressifs (@NextItem, @PreviousItem...)
D
non
prend une direction, en avant ou en arrière (Directional)
F
non
prend une fonction (la condition ou la mise à jour est donnée comme une fonction) ; le document des formes emploie aussi F pour la forme future, qui diffère l'action
Many
non
travaille sur une collection d'éléments au lieu d'un seul (la forme plurielle)
Except
non
prend des exceptions, ce qu'il faut laisser de côté (la forme exceptionnelle)
U
non
rend le résultat sans doublon

Chaque exemple est un fichier de test de la bibliothèque, exécuté dans la bibliothèque pour cette page ; seuls ceux dont la sortie a tenu toutes les promesses écrites par leur fichier sont montrés. Les explications, les titres et le code sont ceux de la bibliothèque, en anglais.

Voir aussi