CKTIS / Python
Decimal.quantize — nastavenie desatinného exponentu
decimal.Decimal.quantize používa exponent argumentu exp ako cieľový exponent a v prípade potreby hodnotu zaokrúhli. Umožňuje určiť požadovaný počet desatinných miest a výslovne vybrať pravidlo zaokrúhľovania. Pri clamp=1 môže byť uložený exponent konečného výsledku nižší než cieľový.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
Decimal.quantize(exp, rounding=None, context=None)decimal.Decimal.quantize vracia nový objekt Decimal. Exponent exp určuje cieľovú mierku: Decimal('0.01') znamená zaokrúhlenie na dve desatinné miesta, nie na násobky hodnoty exp. Ak je v kontexte nastavené clamp=1, operácia môže znížiť uložený exponent konečného výsledku a pridať na koniec jeho koeficientu nuly bez zmeny číselnej hodnoty výsledku.
Argument rounding má prednosť pred pravidlom v context; ak vynecháte oba, použije sa aktuálny kontext. Hodnoty vytvárajte z reťazcov, aby ste neprevzali aproximácie typu float.
Prekročenie presnosti kontextu pre koeficient výsledku signalizuje InvalidOperation: aktívna pasca vyvolá výnimku, inak je výsledkom NaN. Platia aj medze exponentu kontextu. Operácia nikdy nesignalizuje Underflow.
Príklad porovnáva ROUND_HALF_EVEN a ROUND_HALF_UP a ukazuje pridávanie koncových núl.
Príklady
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))Výsledok
2.66 2.67 2.00
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.