Método BigDecimal movePointRight() en Java

Requisito previo: Conceptos básicos de BigDecimal

El método java.math.BigDecimal.movePointRight( int n ) se usa para mover el punto decimal del BigDecimal actual n lugares a la derecha.

• Si n no es negativo, la llamada simplemente resta n de la escala.
• Si n es negativo, la llamada es equivalente a movePointLeft(-n).

El BigDecimal devuelto por este método tiene un valor (this × 10n) y una escala máxima (this.scale()-n, 0).

Sintaxis:

public BigDecimal movePointRight(int n)

Parámetro: El método toma un parámetro n de tipo entero que se refiere al número de lugares que se requiere mover el punto decimal hacia la derecha.

Valor devuelto: el método devuelve el mismo valor BigDecimal con el punto decimal movido n lugares a la derecha.

Excepción: el método lanza una ArithmeticException si la escala se desborda.

Ejemplos:

Input: value = 2300.9856, rightshift = 3
Output: 2300985.6
Explanation:
After shifting the decimal point of 2300.9856 by 3 places to right,
2300985.6 is obtained.
Alternate way: 2300.9856*10^(3)=2300985.6

Input: value = 35001, rightshift = 2
Output: 3500100

El siguiente programa ilustra el método movePointRight() de BigDecimal:

// Program to demonstrate movePointRight() method of BigDecimal 
  
import java.math.*;
  
public class GFG {
  
    public static void main(String[] args)
    {
        // Create BigDecimal object
        BigDecimal bigdecimal = new BigDecimal("2300.9856");
  
        // Create a int i for decimal right move distance
        int i = 3;
  
        // Call movePointRight() method on BigDecimal by shift i
        BigDecimal changedvalue = bigdecimal.movePointRight(i);
  
        String result = "After applying decimal move right
        by move Distance " + i + " on " + bigdecimal + 
        " New Value is " + changedvalue;
  
        // Print result
        System.out.println(result);
    }
}

After applying decimal move right by move Distance 3 on 2300.9856 New Value is 2300985.6

Referencia: https://docs.oracle.com/javase/7/docs/api/java/math/BigDecimal.html#movePointRight(int)