Spec-Zone.ru › OpenJDK 17

Класс 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
Класс Object, представляющий примитивный тип 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
Объект 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 представляет значение true, если строковый аргумент не null и равен, игнорируя регистр, строке "true". В противном случае возвращается значение false, в том числе для 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:
значение boolean системной переменной.
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:
ноль, если этот объект представляет то же значение boolean, что и аргумент; положительное значение, если этот объект представляет true, а аргумент - false; отрицательное значение, если этот объект представляет false, а аргумент - true
Throws:
NullPointerException - если аргумент null
Since:
1.5
See Also:
  • Comparable

сравнить

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

логическоеИ

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

логическоеИли

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

логическоеИсключающееИЛИ

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
Возвращает:
a Optional описывающий экземпляр Boolean
С тех пор:
15

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

Spec-Zone.ru

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