Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`protected void`	`finalize()`	Устарел, подлежит удалению: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в будущем выпуске.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

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), поскольку она, вероятно, обеспечит значительно более высокую эффективность использования памяти и быстродействие. По возможности также рассмотрите использование константных полей 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.