CKTIS / Python
Decimal.quantize — ustalanie wykładnika dziesiętnego
decimal.Decimal.quantize używa wykładnika exp jako wykładnika docelowego i w razie potrzeby zaokrągla wartość. Pozwala ustalić docelową liczbę miejsc po przecinku i jawnie wybrać regułę zaokrąglania. Przy clamp=1 zapisany wykładnik skończonego wyniku może być niższy od docelowego.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
Decimal.quantize(exp, rounding=None, context=None)decimal.Decimal.quantize zwraca nowy Decimal. Wykładnik exp określa docelową skalę: Decimal('0.01') oznacza zaokrąglanie do dwóch miejsc po przecinku, a nie do wielokrotności wartości exp. Jeśli w kontekście ustawiono clamp=1, operacja może obniżyć zapisany wykładnik skończonego wyniku i dopisać zera na końcu współczynnika, nie zmieniając wartości liczbowej wyniku.
Argument rounding ma pierwszeństwo przed regułą z context; bez obu używany jest bieżący kontekst. Twórz wartości z napisów, aby uniknąć przenoszenia przybliżeń float.
Przekroczenie precyzji współczynnika wyniku sygnalizuje InvalidOperation: aktywna pułapka zgłasza wyjątek, inaczej wynikiem jest NaN. Obowiązują też granice wykładnika kontekstu. Operacja nigdy nie sygnalizuje Underflow.
Przykład porównuje ROUND_HALF_EVEN z ROUND_HALF_UP i pokazuje dodawanie końcowych zer.
Przykłady
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))Wynik
2.66 2.67 2.00
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.