Spec-Zone.ru › OpenJDK 21

Класс Boolean

java.lang.Object
java.lang.Boolean
Все реализуемые интерфейсы:
Serializable, Comparable<Boolean>, Constable 
public final class Boolean extends Object implements Serializable, Comparable<Boolean>, Constable
Класс Boolean оборачивает значение примитивного типа boolean в объект. Объект типа Boolean содержит единственное поле типа boolean.

Кроме того, этот класс предоставляет множество методов для преобразования boolean в String и String в boolean, а также другие константы и методы, полезные при работе с boolean.

Это класс с базовым значением; программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать экземпляры для синхронизации, иначе могут возникнуть непредсказуемые последствия. Например, в будущих версиях синхронизация может завершиться сбоем.

С тех пор:
1.0
См. также:
  • Сериализованная форма

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

Модификатор и тип Поле Описание
static final Boolean FALSE
Объект Boolean, соответствующий примитивному значению false.
static final Boolean TRUE
Объект Boolean, соответствующий примитивному значению true.
static final Class<Boolean> TYPE
Объект класса, представляющий примитивный тип boolean.

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

Конструктор Описание
Boolean(boolean value)
Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.
Использование данного конструктора редко уместно.
Boolean(String s)
Устаревший, для удаления: Этот элемент API может быть удален в будущей версии.
Использование данного конструктора редко уместно.

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

Модификатор и тип Метод Описание
boolean booleanValue()
Возвращает значение этого объекта Boolean как примитивное значение boolean.
static int compare(boolean x, boolean y)
Сравнивает два значения boolean.
int compareTo(Boolean b)
Сравнивает этот экземпляр Boolean с другим.
Optional<DynamicConstantDesc<Boolean>> describeConstable()
Возвращает Optional содержащий номинальное описание для этого экземпляра.
boolean equals(Object obj)
Возвращает true только тогда, когда аргумент не является null и является объектом Boolean , представляющим то же значение boolean , что и этот объект.
static boolean getBoolean(String name)
Возвращает true только в том случае, если системная переменная, указанная аргументом, существует и равна, игнорируя регистр, строке "true".
int hashCode()
Возвращает код хэша для этого объекта Boolean.
static int hashCode(boolean value)
Возвращает код хэша для значения boolean; совместимо с Boolean.hashCode().
static boolean logicalAnd(boolean a, boolean b)
Возвращает результат применения логического оператора И к указанным операндам boolean.
static boolean logicalOr(boolean a, boolean b)
Возвращает результат применения логического оператора ИЛИ к указанным операндам boolean.
static boolean logicalXor(boolean a, boolean b)
Возвращает результат применения логического оператора ИСКЛЮЧАЮЩЕЕ ИЛИ к указанным операндам boolean.
static boolean parseBoolean(String s)
Разбирает строковый аргумент как логическое значение.
String toString()
Возвращает объект String , представляющий значение этого Boolean.
static String toString(boolean b)
Возвращает объект String , представляющий указанное boolean значение.
static Boolean valueOf(boolean b)
Возвращает экземпляр Boolean , представляющий указанное значение boolean.
static Boolean valueOf(String s)
Возвращает Boolean со значением, представленным указанной строкой.

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

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

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

TRUE

public static final Boolean TRUE
Объект Boolean , соответствующий примитивному значению true.

FALSE

public static final Boolean FALSE
Объект Boolean , соответствующий примитивному значению false.

TYPE

public static final Class<Boolean> TYPE
Объект Class, представляющий примитивный тип boolean.
Since:
1.1

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

Boolean

@Deprecated(since="9", forRemoval=true) public Boolean(boolean value)
Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.
В редких случаях уместно использовать этот конструктор. Статический фабричный метод valueOf(boolean) обычно является лучшим выбором, так как, вероятно, обеспечит значительно лучшие показатели по затратам памяти и времени. Также рассмотрите возможность использования конечных полей TRUE и FALSE, если это возможно.
Выделяет объект Boolean , представляющий value аргумент.
Parameters:
value - значение Boolean.

Boolean

@Deprecated(since="9", forRemoval=true) public Boolean(String s)
Устаревший, подлежит удалению: Этот элемент API может быть удален в будущей версии.
В редких случаях уместно использовать этот конструктор. Используйте parseBoolean(String) для преобразования строки в примитивный тип boolean, или используйте valueOf(String) для преобразования строки в объект Boolean.
Выделяет объект Boolean , представляющий значение true , если строковый аргумент не null и равен, без учета регистра, строке "true". В противном случае, выделяет объект Boolean , представляющий значение false.
Parameters:
s - строка для преобразования в Boolean.

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

parseBoolean

public static boolean parseBoolean(String s)
Парсит строковый аргумент как boolean. Возвращаемое значение boolean представляет значение true , если строковый аргумент не null и равен, без учета регистра, строке "true". В противном случае, возвращается false, в том числе для null аргумента.

Пример: Boolean.parseBoolean("True") возвращает true.
Пример: Boolean.parseBoolean("yes") возвращает false.

Parameters:
s - строка, содержащая представление boolean для парсинга
Returns:
boolean, представленный строковым аргументом
Since:
1.5

booleanValue

public boolean booleanValue()
Возвращает значение этого объекта Boolean как примитивный тип boolean.
Returns:
примитивное значение boolean этого объекта.

valueOf

public static Boolean valueOf(boolean b)
Возвращает экземпляр Boolean , представляющий заданное значение boolean. Если заданное значение boolean равно true, этот метод возвращает Boolean.TRUE; если оно равно false, этот метод возвращает Boolean.FALSE. Если новый экземпляр Boolean не требуется, этот метод следует предпочитать конструктору Boolean(boolean), так как, вероятно, он обеспечит значительно лучшие показатели по затратам памяти и времени.
Parameters:
b - значение boolean.
Returns:
экземпляр Boolean , представляющий b.
Since:
1.4

valueOf

public static Boolean valueOf(String s)
Возвращает объект Boolean со значением, представленным заданной строкой. Возвращаемый Boolean представляет истинное значение, если строковый аргумент не null и равен, без учета регистра, строке "true". В противном случае возвращается ложное значение, в том числе для null аргумента.
Parameters:
s - строка.
Returns:
значение Boolean , представленное строкой.

toString

public static String toString(boolean b)
Возвращает объект String , представляющий заданный boolean. Если заданный boolean равен true, возвращается строка "true", в противном случае возвращается строка "false".
Parameters:
b - преобразуемый boolean
Returns:
строковое представление заданного boolean
Since:
1.4

toString

public String toString()
Возвращает объект String , представляющий значение этого объекта Boolean. Если этот объект представляет значение true, возвращается строка, равная "true". В противном случае возвращается строка, равная "false".
Overrides:
toString в классе Object
Returns:
строковое представление этого объекта.

hashCode

public int hashCode()
Возвращает хэш-код для этого объекта Boolean.
Overrides:
hashCode в классе Object
Returns:
целое число 1231 , если этот объект представляет true; возвращает целое число 1237 , если этот объект представляет false.
See Also:
  • Object.equals(java.lang.Object)
  • System.identityHashCode(java.lang.Object)

hashCode

public static int hashCode(boolean value)
Возвращает хэш-код для значения boolean , совместимый с Boolean.hashCode().
Parameters:
value - значение для хэширования
Returns:
значение хэш-кода для значения boolean.
Since:
1.8

equals

public boolean equals(Object obj)
Возвращает true тогда и только тогда, когда аргумент не null и является объектом Boolean , который представляет то же значение boolean , что и этот объект.
Overrides:
equals в классе Object
Parameters:
obj - сравниваемый объект.
Returns:
true , если объекты Boolean представляют одно и то же значение; false в противном случае.
See Also:
  • Object.hashCode()
  • HashMap

getBoolean

public static boolean getBoolean(String name)
Возвращает true тогда и только тогда, когда системная переменная, имя которой указано в аргументе, существует и равна, без учета регистра, строке "true". Доступ к системной переменной осуществляется через getProperty, метод, определенный классом System.

Если переменной с указанным именем нет, или если имя пустое или null, то возвращается false.

Parameters:
name - имя системной переменной.
Returns:
логическое значение системной переменной.
Throws:
SecurityException - по тем же причинам, что и System.getProperty
See Also:
  • System.getProperty(java.lang.String)
  • System.getProperty(java.lang.String, java.lang.String)

compareTo

public int compareTo(Boolean b)
Сравнивает этот экземпляр Boolean с другим.
Specified by:
compareTo в интерфейсе Comparable<Boolean>
Parameters:
b - экземпляр Boolean для сравнения
Returns:
ноль, если этот объект представляет то же булево значение, что и аргумент; положительное значение, если этот объект представляет true, а аргумент - false; и отрицательное значение, если этот объект представляет false, а аргумент - true
Throws:
NullPointerException - если аргумент null
Since:
1.5
See Also:
  • Comparable

compare

public static int compare(boolean x, boolean y)
Сравнивает два boolean значения. Возвращаемое значение идентично тому, что было бы возвращено: 
    Boolean.valueOf(x).compareTo(Boolean.valueOf(y))
Параметры:
x - первое boolean для сравнения
y - второе boolean для сравнения
Возвращаемое значение:
значение 0 , если x == y; значение меньше 0 , если !x && y; и значение больше 0 , если x && !y
С:
1.7

logicalAnd

public static boolean logicalAnd(boolean a, boolean b)
Возвращает результат применения логического оператора И к указанным boolean операндам.
Параметры:
a - первый операнд
b - второй операнд
Возвращаемое значение:
логическое И от a и b
С:
1.8
См. также:
  • BinaryOperator

logicalOr

public static boolean logicalOr(boolean a, boolean b)
Возвращает результат применения логического оператора ИЛИ к указанным boolean операндам.
Параметры:
a - первый операнд
b - второй операнд
Возвращаемое значение:
логическое ИЛИ от a и b
С:
1.8
См. также:
  • BinaryOperator

logicalXor

public static boolean logicalXor(boolean a, boolean b)
Возвращает результат применения логического оператора ИСКЛЮЧАЮЩЕЕ ИЛИ к указанным boolean операндам.
Параметры:
a - первый операнд
b - второй операнд
Возвращаемое значение:
логическое ИСКЛЮЧАЮЩЕЕ ИЛИ от a и b
С:
1.8
См. также:
  • BinaryOperator

describeConstable

public Optional<DynamicConstantDesc<Boolean>> describeConstable()
Возвращает Optional, содержащий номинальный дескриптор для этого экземпляра.
Определено в:
describeConstable в интерфейсе Constable
Возвращаемое значение:
an Optional описывающий экземпляр Boolean
С:
15

© 1993, 2023, 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/21/docs/api/java.base/java/lang/Boolean.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API