Added in API level 1

RoundingMode

class RoundingMode

kotlin.Any
↳	kotlin.Enum<java.math.RoundingMode>
	↳	java.math.RoundingMode

Known Direct Subclasses

RoundingMode.CEILING, RoundingMode.DOWN, RoundingMode.FLOOR, RoundingMode.HALF_DOWN, RoundingMode.HALF_EVEN, RoundingMode.HALF_UP, RoundingMode.UNNECESSARY, RoundingMode.UP

RoundingMode.CEILING	Rounding mode to round towards positive infinity.
RoundingMode.DOWN	Rounding mode where the values are rounded towards zero.
RoundingMode.FLOOR	Rounding mode to round towards negative infinity.
RoundingMode.HALF_DOWN	Rounding mode where values are rounded towards the nearest neighbor.
RoundingMode.HALF_EVEN	Rounding mode where values are rounded towards the nearest neighbor.
RoundingMode.HALF_UP	Rounding mode where values are rounded towards the nearest neighbor.
RoundingMode.UNNECESSARY	Rounding mode where the rounding operations throws an ArithmeticException for the case that rounding is necessary, i.
RoundingMode.UP	Rounding mode where positive values are rounded towards positive infinity and negative values towards negative infinity.

Specifies the rounding behavior for operations whose results cannot be represented exactly.

Summary

Enum values
`CEILING` Rounding mode to round towards positive infinity.
`DOWN` Rounding mode where the values are rounded towards zero.
`FLOOR` Rounding mode to round towards negative infinity.
`HALF_DOWN` Rounding mode where values are rounded towards the nearest neighbor.
`HALF_EVEN` Rounding mode where values are rounded towards the nearest neighbor.
`HALF_UP` Rounding mode where values are rounded towards the nearest neighbor.
`UNNECESSARY` Rounding mode where the rounding operations throws an ArithmeticException for the case that rounding is necessary, i.
`UP` Rounding mode where positive values are rounded towards positive infinity and negative values towards negative infinity.

Public methods
static RoundingMode!	`valueOf(mode: Int)` Converts rounding mode constants from class `BigDecimal` into `RoundingMode` values.

Enum values

CEILING

Added in API level 1

enum val CEILING : RoundingMode

Rounding mode to round towards positive infinity. For positive values this rounding mode behaves as UP, for negative values as DOWN.
Rule: x.round() >= x

DOWN

Added in API level 1

enum val DOWN : RoundingMode

Rounding mode where the values are rounded towards zero.
Rule: x.round().abs() <= x.abs()

FLOOR

Added in API level 1

enum val FLOOR : RoundingMode

Rounding mode to round towards negative infinity. For positive values this rounding mode behaves as DOWN, for negative values as UP.
Rule: x.round() <= x

HALF_DOWN

Added in API level 1

enum val HALF_DOWN : RoundingMode

Rounding mode where values are rounded towards the nearest neighbor. Ties are broken by rounding down.

HALF_EVEN

Added in API level 1

enum val HALF_EVEN : RoundingMode

Rounding mode where values are rounded towards the nearest neighbor. Ties are broken by rounding to the even neighbor.

HALF_UP

Added in API level 1

enum val HALF_UP : RoundingMode

Rounding mode where values are rounded towards the nearest neighbor. Ties are broken by rounding up.

UNNECESSARY

Added in API level 1

enum val UNNECESSARY : RoundingMode

Rounding mode where the rounding operations throws an ArithmeticException for the case that rounding is necessary, i.e. for the case that the value cannot be represented exactly.

UP

Added in API level 1

enum val UP : RoundingMode

Rounding mode where positive values are rounded towards positive infinity and negative values towards negative infinity.
Rule: x.round().abs() >= x.abs()

Public methods

valueOf

Added in API level 1

static fun valueOf(mode: Int): RoundingMode!

Converts rounding mode constants from class BigDecimal into RoundingMode values.

Parameters
`mode`	Int: rounding mode constant as defined in class `BigDecimal`

Return
`RoundingMode!`	corresponding rounding mode object