Класс 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`	Объект Class, представляющий примитивный тип boolean.

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

Конструктор	Описание
`Boolean(boolean value)`	Устарел. Использование этого конструктора редко бывает уместным.
`Boolean(String s)`	Устарел. Использование этого конструктора редко бывает уместным.

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

Модификатор и тип	Метод	Описание
`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)`	Разбирает строковый аргумент как логическое значение.
`String`	`toString()`	Возвращает объект `String`, представляющий значение этого Boolean.
`static String`	`toString(boolean b)`	Возвращает объект `String`, представляющий заданное логическое значение.
`static Boolean`	`valueOf(boolean b)`	Возвращает экземпляр `Boolean`, представляющий заданное значение `boolean`.
`static Boolean`	`valueOf(String s)`	Возвращает `Boolean` со значением, представленным заданной строкой.

Методы, объявленные в классе 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.

Начиная с:: 1.1

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

Boolean

@Deprecated(since="9") public Boolean(boolean value)

Устарел.

Использование этого конструктора редко бывает уместным. Обычно лучше использовать статическую фабрику valueOf(boolean), поскольку она, вероятно, обеспечит значительно более высокую эффективность использования памяти и времени. По возможности также рассмотрите возможность использования полей final TRUE и FALSE.

Выделяет объект Boolean, представляющий аргумент value.

Параметры:: value — значение Boolean.

Boolean

@Deprecated(since="9") public Boolean(String s)

Устарел.

Использование этого конструктора редко бывает уместным. Используйте parseBoolean(String), чтобы преобразовать строку в примитив boolean, или valueOf(String), чтобы преобразовать строку в объект Boolean.

Выделяет объект Boolean, представляющий значение true, если строковый аргумент не является null и равен строке "true" без учёта регистра. В противном случае выделяет объект Boolean, представляющий значение false.

Параметры:: s — строка для преобразования в Boolean.

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

parseBoolean

public static boolean parseBoolean(String s)

Разбирает строковый аргумент как логическое значение. Возвращённое значение boolean равно true, если строковый аргумент не является null и равен строке "true" без учёта регистра. В противном случае возвращается значение false, в том числе если аргумент равен null.

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

Параметры:: s — String, содержащее строковое представление логического значения для разбора
Возвращает:: логическое значение, представленное строковым аргументом
Начиная с:: 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, представляющий b.
Начиная с:: 1.4

valueOf

public static Boolean valueOf(String s)

Возвращает Boolean со значением, представленным заданной строкой. Возвращённое значение Boolean равно true, если строковый аргумент не является null и равен строке "true" без учёта регистра. В противном случае возвращается значение false, в том числе если аргумент равен null.

Параметры:: s — строка.
Возвращает:: значение Boolean, представленное строкой.

toString

public static String toString(boolean b)

Возвращает объект String, представляющий заданное логическое значение. Если заданное логическое значение равно true, будет возвращена строка "true", в противном случае будет возвращена строка "false".

Параметры:: b — логическое значение для преобразования
Возвращает:: строковое представление заданного значения 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.

См. также:

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.

См. также:

getBoolean

public static boolean getBoolean(String name)

Возвращает true тогда и только тогда, когда системное свойство с именем, заданным аргументом, существует и равно строке "true" без учёта регистра. К системному свойству можно получить доступ с помощью getProperty — метода, определённого в классе System.

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

Параметры:

name — имя системного свойства.

Возвращает:

значение boolean системного свойства.

См. также:

compareTo

public int compareTo(Boolean b)

Сравнивает этот экземпляр Boolean с другим.

Определено в:

compareTo в интерфейсе Comparable<Boolean>

Параметры:

b — экземпляр Boolean для сравнения

Возвращает:

ноль, если этот объект представляет то же логическое значение, что и аргумент; положительное значение, если этот объект представляет true, а аргумент — false; отрицательное значение, если этот объект представляет false, а аргумент — true

Выбрасывает:

NullPointerException — если аргумент равен null

Начиная с:

1.5

См. также:

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)

Возвращает результат применения логического оператора AND к заданным операндам boolean.

Параметры:

a — первый операнд

b — второй операнд

Возвращает:

логическое AND значений a и b

Начиная с:

1.8

См. также:

logicalOr

public static boolean logicalOr(boolean a, boolean b)

Возвращает результат применения логического оператора OR к заданным операндам boolean.

Параметры:

a — первый операнд

b — второй операнд

Возвращает:

логическое OR значений a и b

Начиная с:

1.8

См. также:

logicalXor

public static boolean logicalXor(boolean a, boolean b)

Возвращает результат применения логического оператора XOR к заданным операндам boolean.

Параметры:

a — первый операнд

b — второй операнд

Возвращает:

логическое XOR значений a и b

Начиная с:

1.8

См. также:

describeConstable

public Optional<DynamicConstantDesc<Boolean>> describeConstable()

Возвращает Optional, содержащий номинальный дескриптор этого экземпляра.

Определено в:: describeConstable в интерфейсе Constable
Возвращает:: Optional, описывающий экземпляр Boolean
Начиная с:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/Boolean.html