Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła