CKTIS / Python
Decimal.quantize — een decimale exponent instellen
decimal.Decimal.quantize neemt de exponent van exp als doelexponent en rondt de waarde zo nodig af. Hiermee kun je het gewenste aantal decimalen opgeven en expliciet een afrondingsregel kiezen. Bij clamp=1 kan de opgeslagen exponent van een eindig resultaat lager zijn dan de doelexponent.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
Decimal.quantize(exp, rounding=None, context=None)decimal.Decimal.quantize geeft een nieuwe Decimal terug. De exponent van exp bepaalt de gewenste schaal: Decimal('0.01') staat voor afronden op twee decimalen, niet op veelvouden van de waarde van exp. Als clamp=1 in de context, kan de bewerking de opgeslagen exponent van een eindig resultaat verlagen en nullen achter de coëfficiënt plaatsen zonder de numerieke waarde van het resultaat te veranderen.
Het argument rounding gaat voor op de regel in context; als beide ontbreken, wordt de huidige context gebruikt. Maak waarden aan vanuit tekenreeksen om te voorkomen dat benaderingen van float worden overgenomen.
Als de contextprecisie voor de coëfficiënt van het resultaat wordt overschreden, wordt InvalidOperation gesignaleerd: een ingeschakelde trap veroorzaakt een uitzondering; anders is het resultaat NaN. Ook de exponentlimieten van de context gelden. De bewerking signaleert nooit Underflow.
Het voorbeeld vergelijkt ROUND_HALF_EVEN met ROUND_HALF_UP en laat zien hoe afsluitende nullen worden toegevoegd.
Voorbeelden
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))Resultaat
2.66 2.67 2.00
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.