CKTIS / Python
Decimal.quantize — določanje decimalnega eksponenta
decimal.Decimal.quantize uporabi eksponent argumenta exp kot ciljni eksponent in po potrebi zaokroži vrednost. Tako lahko določimo želeno število decimalnih mest in izrecno izberemo pravilo zaokroževanja. Pri clamp=1 je lahko shranjeni eksponent končnega rezultata nižji od ciljnega.
Različica: Python 3.14; repository image, production runtime not attested
Sintaksa
Decimal.quantize(exp, rounding=None, context=None)decimal.Decimal.quantize vrne nov Decimal. Eksponent exp določa ciljno merilo: Decimal('0.01') pomeni zaokroževanje na dve decimalni mesti, ne na večkratnike vrednosti exp. Če je v kontekstu nastavljeno clamp=1, lahko operacija zniža shranjeni eksponent končnega rezultata in na konec njegovega koeficienta doda ničle, ne da bi spremenila številsko vrednost rezultata.
Argument rounding ima prednost pred pravilom v context; če izpustimo oba, se uporabi trenutni kontekst. Vrednosti ustvarjajte iz nizov, da ne prevzamete približkov tipa float.
Če je za koeficient rezultata presežena natančnost konteksta, se signalizira InvalidOperation: aktivna past sproži izjemo, sicer je rezultat NaN. Veljajo tudi eksponentne meje konteksta. Operacija nikoli ne signalizira Underflow.
Primer primerja ROUND_HALF_EVEN z ROUND_HALF_UP in pokaže dodajanje končnih ničel.
Primeri
from decimal import Context, Decimal, ROUND_HALF_EVEN, ROUND_HALF_UP
ctx = Context(prec=10)
value = Decimal('2.665')
places = Decimal('0.01')
print(value.quantize(places, rounding=ROUND_HALF_EVEN, context=ctx))
print(value.quantize(places, rounding=ROUND_HALF_UP, context=ctx))
print(Decimal('2').quantize(places, context=ctx))Rezultat
2.66 2.67 2.00
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.