Python | Decimal next_toward() method

Decimal#next_toward() : next_toward() is a Decimal class method which returns the number closest to first decimal value in the direction towards second decimal value.

Syntax: Decimal.next_toward()

Parameter: Decimal values

Return: the number closest to first decimal value in the direction towards second decimal value.

Code #1 : Example for next_toward() method

# Python Program explaining
# next_toward() method

# loading decimal library
from decimal import *


# Initializing a decimal value
a = Decimal(-1)

b = Decimal('0.142857')

# printing Decimal values
print ("Decimal value a : ", a)
print ("Decimal value b : ", b)


# Using Decimal.next_toward() method
print ("\n\nDecimal a with next_toward() method : ", a.next_toward(b))

print ("Decimal b with next_toward() method : ", b.next_toward(b))

Output :

Decimal value a :  -1
Decimal value b :  0.142857


Decimal a with next_toward() method :  -0.9999999999999999999999999999
Decimal b with next_toward() method :  0.142857

Code #2 : Example for next_toward() method

# Python Program explaining
# next_toward() method

# loading decimal library
from decimal import *


# Initializing a decimal value
a = Decimal('-3.14')

b = Decimal('321e + 5')


# printing Decimal values
print ("Decimal value a : ", a)
print ("Decimal value b : ", b)


# Using Decimal.next_toward() method
print ("\n\nDecimal a with next_toward() method : ", a.next_toward(b))

print ("Decimal b with next_toward() method : ", b.next_toward(b))

Output :

Decimal value a :  -3.14
Decimal value b :  3.21E+7


Decimal a with next_toward() method :  -3.139999999999999999999999999
Decimal b with next_toward() method :  3.21E+7