Класс MathContext

java.lang.Object

java.math.MathContext

Все реализованные интерфейсы:: Serializable

public final class MathContext extends Object implements Serializable

Неизменяемые объекты, которые инкапсулируют настройки контекста, описывающие определённые правила для числовых операторов, такие как те, которые реализованы классом BigDecimal.

Независимые от основания настройки:

precision: количество цифр, используемых для операции; результаты округляются до этой точности
roundingMode: объект RoundingMode, который определяет алгоритм, используемый для округления.

С тех пор:

1.5

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final MathContext`	`DECIMAL128`	Объект `MathContext` с настройкой точности, соответствующей точности формата decimal128 IEEE 754-2019, 34 цифры и режимом округления `HALF_EVEN`.
`static final MathContext`	`DECIMAL32`	Объект `MathContext` с настройкой точности, соответствующей точности формата decimal32 IEEE 754-2019, 7 цифры и режимом округления `HALF_EVEN`.
`static final MathContext`	`DECIMAL64`	Объект `MathContext` с настройкой точности, соответствующей точности формата decimal64 IEEE 754-2019, 16 цифры и режимом округления `HALF_EVEN`.
`static final MathContext`	`UNLIMITED`	Объект `MathContext` с настройками, имеющими значения, необходимые для арифметики с неограниченной точностью.

Краткое описание конструкторов

Конструктор	Описание
`MathContext(int setPrecision)`	Создаёт новый `MathContext` с указанной точностью и режимом округления `HALF_UP`.
`MathContext(int setPrecision, RoundingMode setRoundingMode)`	Создаёт новый `MathContext` с указанной точностью и режимом округления.
`MathContext(String val)`	Создаёт новый `MathContext` из строки.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object x)`	Сравнивает этот `MathContext` с указанным `Object` на равенство.
`int`	`getPrecision()`	Возвращает настройку `precision`.
`RoundingMode`	`getRoundingMode()`	Возвращает настройку roundingMode.
`int`	`hashCode()`	Возвращает хэш-код для этого `MathContext`.
`String`	`toString()`	Возвращает строковое представление этого `MathContext`.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание полей

UNLIMITED

public static final MathContext UNLIMITED

Объект MathContext, настройки которого имеют значения, необходимые для арифметики с неограниченной точностью. Значения настроек: precision=0 roundingMode=HALF_UP

DECIMAL32

public static final MathContext DECIMAL32

Объект MathContext с настройкой точности, соответствующей точности формата decimal32 IEEE 754-2019, 7 цифр и режимом округления HALF_EVEN. Обратите внимание, что диапазон показателей степени decimal32 не используется для округления.

DECIMAL64

public static final MathContext DECIMAL64

Объект MathContext с настройкой точности, соответствующей точности формата decimal64 IEEE 754-2019, 16 цифр и режимом округления HALF_EVEN. Обратите внимание, что диапазон показателей степени decimal64 не используется для округления.

DECIMAL128

public static final MathContext DECIMAL128

Объект MathContext с настройкой точности, соответствующей точности формата decimal128 IEEE 754-2019, 34 цифр и режимом округления HALF_EVEN. Обратите внимание, что диапазон показателей степени decimal64 не используется для округления.

Подробное описание конструкторов

MathContext

public MathContext(int setPrecision)

Создает новый объект MathContext с заданной точностью и режимом округления HALF_UP.

Параметры:: setPrecision - Настройка точности, неотрицательное int значение.
Исключения:: IllegalArgumentException - если параметр setPrecision меньше нуля.

MathContext

public MathContext(int setPrecision, RoundingMode setRoundingMode)

Создает новый объект MathContext со специфицированной точностью и режимом округления.

Параметры:: setPrecision - Настройка точности, неотрицательное int значение.; setRoundingMode - Используемый режим округления.
Исключения:: IllegalArgumentException - если параметр setPrecision меньше нуля.; NullPointerException - если аргумент режима округления null

MathContext

public MathContext(String val)

Создает новый объект MathContext из строки. Строка должна быть в том же формате, что и та, которая создается методом toString().

Исключение IllegalArgumentException выбрасывается, если часть строки с точностью выходит за пределы диапазона (< 0) или строка не имеет формата, созданного методом toString().

Параметры:: val - Строка для парсинга
Исключения:: IllegalArgumentException - если часть строки с точностью выходит за пределы диапазона или имеет неправильный формат; NullPointerException - если аргумент null

Подробное описание методов

getPrecision

public int getPrecision()

Возвращает настройку precision. Это значение всегда неотрицательно.

Возвращает:: значение настройки int, которое представляет собой значение настройки precision

getRoundingMode

public RoundingMode getRoundingMode()

Возвращает настройку roundingMode. Это будет одно из значений RoundingMode.CEILING, RoundingMode.DOWN, RoundingMode.FLOOR, RoundingMode.HALF_DOWN, RoundingMode.HALF_EVEN, RoundingMode.HALF_UP, RoundingMode.UNNECESSARY или RoundingMode.UP.

Возвращает:: объект RoundingMode, который представляет собой значение настройки roundingMode

equals

public boolean equals(Object x)

Сравнивает этот объект MathContext с заданным объектом Object на равенство.

Переопределяет:

equals в классе Object

Параметры:

x - Объект Object, с которым сравнивается этот объект MathContext.

Возвращает:

true тогда и только тогда, когда заданный объект Object является объектом MathContext, который имеет ровно те же настройки, что и этот объект

См. также:

hashCode

public int hashCode()

Возвращает код хэширования для этого объекта MathContext.

Переопределяет:

hashCode в классе Object

Возвращает:

код хэширования для этого объекта MathContext

См. также:

toString

public String toString()

Возвращает строковое представление этого объекта MathContext. Возвращаемая строка представляет настройки объекта MathContext как два слова, разделенных пробелами (разделенные одним символом пробела, '\u0020', без начальных и конечных пробелов), следующим образом:

Строка "precision=", за которой следует значение настройки точности в виде числовой строки, как если бы она была сгенерирована методом Integer.toString.
Строка "roundingMode=", за которой следует значение настройки roundingMode в виде слова. Это слово будет таким же, как имя соответствующей публичной константы в перечислении RoundingMode.

Например:

 precision=9 roundingMode=HALF_UP

Дополнительные слова могут быть добавлены к результату вызова метода toString в будущем, если к этому классу будут добавлены новые свойства.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление настроек контекста

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/math/MathContext.html