Метод negate

Метод negate класса BigDecimal возвращает новый объект BigDecimal, значение которого равно исходному числу с противоположным знаком. Если исходное число было положительным, результат будет отрицательным, и наоборот. Если исходное число равно нулю, результат также будет равен нулю. Метод не принимает параметров и не изменяет исходный объект, поскольку класс BigDecimal является неизменяемым.

Синтаксис

public BigDecimal negate()

Пример

Давайте создадим объект BigDecimal с положительным значением и получим его отрицательную копию:

import java.math.BigDecimal;

public class Main
{
	public static void main(String[] args)
	{
		BigDecimal num = new BigDecimal("123.45");
		BigDecimal res = num.negate();
		
		System.out.println(res);
	}
}

Результат выполнения кода:

-123.45

Пример

Давайте применим метод negate к отрицательному числу и убедимся, что знак меняется на противоположный:

import java.math.BigDecimal;

public class Main
{
	public static void main(String[] args)
	{
		BigDecimal num = new BigDecimal("-123.45");
		BigDecimal res = num.negate();
		
		System.out.println(res);
	}
}

Результат выполнения кода:

123.45

Пример

Давайте проверим, что метод negate не изменяет исходный объект, а возвращает новый:

import java.math.BigDecimal;

public class Main
{
	public static void main(String[] args)
	{
		BigDecimal num = new BigDecimal("123.45");
		BigDecimal res = num.negate();
		
		System.out.println("Original: " + num);
		System.out.println("Negated: " + res);
	}
}

Результат выполнения кода:

Original: 123.45
Negated: -123.45

Смотрите также

класс BigDecimal,
который представляет неизменяемые десятичные числа
метод abs,
который возвращает абсолютное значение числа
метод add,
который складывает два числа BigDecimal
метод subtract,
который вычитает одно число BigDecimal из другого