java命名空间java.math类bigdecimal的类成员方法:
setscale定义及介绍
本文导语:
setscale
public bigdecimal setscale(int newscale,
int roundingmode)
返回一个 bigdecimal,其标度为指定值,其非标度值通过此 bigdecimal 的非标度值乘以或除以十的适当次幂来确定,以维护其总值。如果该操作减少标度,则...
setscale
public bigdecimal setscale(int newscale,
int roundingmode)
- 返回一个 bigdecimal,其标度为指定值,其非标度值通过此 bigdecimal 的非标度值乘以或除以十的适当次幂来确定,以维护其总值。如果该操作减少标度,则非标度值必须被除(而不是乘),并且该值可以更改;在这种情况下,将指定的舍入模式应用到除法中。
注意,由于 bigdecimal 对象是不可变的,此方法的调用不会 导致初始对象被修改,这与使用名为 setx 变异字段 x 方法的常规约定相反。相反,setscale 返回具有适当标度的对象;返回的对象不一定是新分配的。
相对于此遗留方法,应优先使用新的 setscale(int, roundingmode)
方法。
- 参数:
newscale
- 要返回的 bigdecimal 值的标度。roundingmode
- 要应用的舍入模式。
- 返回:
- 一个 bigdecimal,其标度为指定值,其非标度值可以通过此 bigdecimal 的非标度值乘以或除以十的适当次幂来确定。
- 抛出:
arithmeticexception
- 如果 roundingmode==round_unnecessary,并且指定的标度操作要求进行舍入。
illegalargumentexception
- 如果 roundingmode 不表示一个有效的舍入模式。- 另请参见:
round_up
,
round_down
,
round_ceiling
,
round_floor
,
round_half_up
,
round_half_down
,
round_half_even
,
round_unnecessary