CKTIS / Python
Decimal.quantize — nastavení desetinného exponentu
decimal.Decimal.quantize používá exponent argumentu exp jako cílový exponent a v případě potřeby hodnotu zaokrouhlí. Umožňuje určit požadovaný počet desetinných míst a výslovně zvolit pravidlo zaokrouhlování. Při clamp=1 může být uložený exponent konečného výsledku nižší než cílový.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
Decimal.quantize(exp, rounding=None, context=None)decimal.Decimal.quantize vrací nový objekt Decimal. Exponent exp určuje cílové měřítko: Decimal('0.01') znamená zaokrouhlení na dvě desetinná místa, nikoli na násobky hodnoty exp. Pokud je v kontextu nastaveno clamp=1, může operace snížit uložený exponent konečného výsledku a přidat na konec jeho koeficientu nuly, aniž se změní číselná hodnota výsledku.
Argument rounding má přednost před pravidlem v context; pokud vynecháte oba, použije se aktuální kontext. Hodnoty vytvářejte z řetězců, abyste nepřevzali aproximace typu float.
Překročení přesnosti kontextu pro koeficient výsledku signalizuje InvalidOperation: aktivní past vyvolá výjimku, jinak je výsledkem NaN. Platí také meze exponentu kontextu. Operace nikdy nesignalizuje Underflow.
Příklad porovnává ROUND_HALF_EVEN a ROUND_HALF_UP a ukazuje přidávání koncových nul.
Pří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ýsledek
2.66 2.67 2.00
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.