Spec-Zone.ru › OpenJDK 24

Класс 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)
Возвращает результат применения логического оператора AND к заданным операндам boolean.
static boolean logicalOr(boolean a, boolean b)
Возвращает результат применения логического оператора OR к заданным операндам boolean.
static boolean logicalXor(boolean a, boolean b)
Возвращает результат применения логического оператора XOR к заданным операндам boolean.
static boolean parseBoolean(String s)
Парсит строковый аргумент как boolean.
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
Класс-объект, представляющий примитивный тип boolean.
С момента:
1.1

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

Boolean

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

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

parseBoolean

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

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

Параметры:
s - строка, содержащая представление boolean для парсинга
Возвращает:
boolean-значение, представленное строковым аргументом
С момента:
1.5

booleanValue

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

valueOf

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

valueOf

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

toString

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

toString

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

hashCode

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

hashCode

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

equals

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

getBoolean

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

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

Параметры:
name - имя системной переменной.
Возвращает:
значение boolean системной переменной.
См. также:
  • System.getProperty(java.lang.String)
  • System.getProperty(java.lang.String, java.lang.String)

compareTo

public int compareTo(Boolean b)
Сравнивает этот экземпляр Boolean с другим.
Задано в:
compareTo в интерфейсе Comparable<Boolean>
Параметры:
b - экземпляр Boolean для сравнения
Возвращает:
ноль, если этот объект представляет то же значение boolean, что и аргумент; положительное значение, если этот объект представляет true, а аргумент - false; и отрицательное значение, если этот объект представляет false, а аргумент - true
Исключение:
NullPointerException - если аргумент равен null
С момента:
1.5
См. также:
  • Comparable

compare

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

logicalAnd

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

logicalOr

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

logicalXor

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

describeConstable

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Boolean.html

Spec-Zone.ru

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