Класс Boolean

Все реализованные интерфейсы:
Serializable, Comparable<Boolean>
public final class Boolean
extends Object
implements Serializable, Comparable<Boolean>

Класс Boolean оборачивает значение примитивного типа boolean в объект. Объект типа Boolean содержит единственное поле типа boolean.

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

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

Поля

Модификатор и тип Поле Описание
static Boolean FALSE

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

static Boolean TRUE

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

static 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 с другим.

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

Объект 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 - строка, содержащая булево представление для парсинга
Возвращает:
булево значение, представленное строковым аргументом
С:
1.5

booleanValue

public boolean booleanValue()

Возвращает значение этого объекта Boolean как примитивное булево значение.

Возвращает:
примитивное булево значение этого объекта.

valueOf

public static Boolean valueOf(boolean b)

Возвращает экземпляр 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 - строка.
Возвращает:
булево значение, представленное строкой.

toString

public static String toString(boolean b)

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

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

Параметры:
value - значение для хэширования
Возвращает:
значение хэш-кода для булева значения.
С:
1.8

equals

public boolean equals(Object obj)

Возвращает true тогда и только тогда, когда аргумент не null и является объектом Boolean, представляющим то же булево значение, что и этот объект.

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

getBoolean

public static boolean getBoolean(String name)

Возвращает true тогда и только тогда, когда системная переменная, названная аргументом, существует и равна, не учитывая регистр, строке "true". Доступ к системной переменной осуществляется через getProperty, метод, определенный классом System.

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

Параметры:
name - имя системной переменной.
Возвращает:
булево значение системной переменной.
Исключения:
SecurityException - по тем же причинам, что и System.getProperty
См. также:
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 для сравнения
Возвращает:
ноль, если этот объект представляет то же булево значение, что и аргумент; положительное значение, если этот объект представляет true, а аргумент - false; и отрицательное значение, если этот объект представляет false, а аргумент - true
Исключения:
NullPointerException - если аргумент null
С:
1.5
См. также:
Comparable

compare

public static int compare(boolean x,
                          boolean y)

Сравнивает два булевых значения. Возвращаемое значение идентично тому, что было бы возвращено:

Boolean.valueOf(x).compareTo(Boolean.valueOf(y))

Параметры:
x - первое булево значение для сравнения
y - второе булево значение для сравнения
Возвращает:
значение 0 если x == y; значение меньше 0 если !x && y; и значение больше 0 если x && !y
С:
1.7

logicalAnd

public static boolean logicalAnd(boolean a,
                                 boolean b)

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

Параметры:
a - первый операнд
b - второй операнд
Возвращает:
логическое И от a и b
С:
1.8
См. также:
BinaryOperator

logicalOr

public static boolean logicalOr(boolean a,
                                boolean b)

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

Параметры:
a - первый операнд
b - второй операнд
Возвращает:
логическое ИЛИ от a и b
С:
1.8
См. также:
BinaryOperator

logicalXor

public static boolean logicalXor(boolean a,
                                 boolean b)

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

Параметры:
a - первый операнд
b - второй операнд
Возвращает:
логическое ИСКЛЮЧАЮЩЕЕ ИЛИ от a и b
С:
1.8
См. также:
BinaryOperator

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

Spec-Zone .ru
спецификации, руководства, описания, API