Por favor, lembre-se que esta tradução da especificação é resultado de um projeto da comunidade java.net( https://jdk5-api-pt-br.dev.java.net/). A versão oficial da especificação é a versão na língua inglesa que pode ser encontrada em http://java.sun.com/j2se/1.5.0/docs/api/. Em caso de divergências, a versão predominante da especificação é a original em inglês.

Please note that this translation of the specification is the result of a java.net community project ( https://jdk5-api-pt-br.dev.java.net/ ). The official version of the specification is the US English language version which can be found at http://java.sun.com/j2se/1.5.0/docs/api/. In case of disputes, the authoritative version of the specification is the original, English document.

java.lang
Class Boolean

java.lang.Object
  java.lang.Boolean

All Implemented Interfaces:

Serializable, Comparable<Boolean>

public final class Boolean
extends Object
implements Serializable, Comparable<Boolean>

A classe Boolean empacota um valor do tipo primitivo boolean em um objeto. Um objeto do tipo Boolean contém um campo simples cujo o tipo é boolean.

Em adição, esta classe fornece muitos métodos para converter um boolean para uma String e uma String para um boolean, bem como outras constantes e métodos úteis quando lidando com um boolean.

Since:

JDK1.0

See Also:

Serialized Form

Field Summary

static Boolean	FALSE O objeto Boolean correspondente ao valor primitivo false.
static Boolean	TRUE O objeto Boolean correspondente ao valor primitivo true.
static Class<Boolean>	TYPE O objeto Class representando o tipo primitivo boolean.

Constructor Summary

Boolean(boolean value)
Aloca um objeto Boolean representando o argumento value.

Boolean(String s)
Aloca um objeto Boolean representando o valor true se o argumento string não for null e for igual, ignorando o caso, à string "true".

Method Summary

boolean	booleanValue() Retorna o valor deste objeto Boolean como um boolean primitivo.
int	compareTo(Boolean b) Compara esta instância Boolean com uma outra.
boolean	equals(Object obj) Retorna true se e apenas se o argumento não for null e for um objeto Boolean que representa o mesmo valor boolean deste objeto.
static boolean	getBoolean(String name) Retorna true se e apenas se a propriedade de sistema nomeada pelo argumento existe e é igual a string "true".
int	hashCode() Retorna um código hash para este objeto Boolean.
static boolean	parseBoolean(String s) Analisa o argumento string como um boolean.
String	toString() Retorna um objeto String representando o valor deste Boolean.
static String	toString(boolean b) Retorna um objeto String representando o boolean especificado.
static Boolean	valueOf(boolean b) Retorna uma instância de Boolean representando o valor boolean especificado.
static Boolean	valueOf(String s) Retorna um Boolean com um valor representado pela String especificada.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

TRUE

public static final Boolean TRUE

O objeto Boolean correspondente ao valor primitivo true.

FALSE

public static final Boolean FALSE

O objeto Boolean correspondente ao valor primitivo false.

TYPE

public static final Class<Boolean> TYPE

O objeto Class representando o tipo primitivo boolean.

Since:

JDK1.1

Constructor Detail

Boolean

public Boolean(boolean value)

Aloca um objeto Boolean representando o argumento value.

Nota: É raramente apropriado usar este construtor. A menos que uma nova instância seja requerida, a fábrica estática valueOf(boolean) é geralmente uma escolha melhor. É possível dar desempenho de tempo e espaço significantemente melhor.

Parameters:

value - o valor do Boolean.

Boolean

public Boolean(String s)

Aloca um objeto Boolean representando o valor true se o argumento string não for null e for igual, ignorando o caso, à string "true". Caso contrário, aloca um objeto Boolean representando o valor false. Exemplos:

new Boolean("True") produz um objeto Boolean que representa true.
new Boolean("yes") produz um objeto Boolean que representa false.

Parameters:

s - a string a ser convertida para um Boolean.

Method Detail

parseBoolean

public static boolean parseBoolean(String s)

Analisa o argumento string como um boolean. O boolean retornado representa o valor true se o argumento string não for null e for igual, ignorando o caso, à string "true".

Parameters:

s - a String contendo a representação booleana a ser analisada

Returns:

o boolean representado pelo argumento string

Since:

1.5

booleanValue

public boolean booleanValue()

Retorna o valor deste objeto Boolean como um boolean primitivo.

Returns:

o valor boolean primitivo deste objeto.

valueOf

public static Boolean valueOf(boolean b)

Retorna uma instância de Boolean representando o valor boolean especificado. Se o valor boolean especificado for true, este método retorna Boolean.TRUE; se for false, este método retorna Boolean.FALSE. Se uma nova instância de Boolean não for requerida, este método deveria normalmente ser usado em preferência ao construtor Boolean(boolean), assim este método é apropriado para dar desempenho de tempo e espaço significantemente melhor.

Parameters:

b - um valor booleano.

Returns:

uma instância de Boolean representando b.

Since:

1.4

valueOf

public static Boolean valueOf(String s)

Retorna um Boolean com um valor representado pela String especificada. O Boolean retornado representa o valor true se o argumento string não for null e for igual, ignorando o caso, à string "true".

Exemplo: Boolean.valueOf("True") retorna true.
Exemplo: Boolean.valueOf("yes") retorna false.

Parameters:

s - uma string.

Returns:

o valor Boolean representado pela string.

toString

public static String toString(boolean b)

Retorna um objeto String representando o boolean especificado. Se o boolean especificado for true, então a string "true" será retornada, caso contrário a string "false" será retornada.

Parameters:

b - o booleano a ser convertido

Returns:

a representação string do boolean especificado.

Since:

1.4

toString

public String toString()

Retorna um objeto String representando o valor deste Boolean. Se este objeto representa o valor true, uma string igual a "true" é retornada. Caso contrário, uma string igual a "false" é retornada.

Overrides:

toString in class Object

Returns:

uma representação string deste objeto.

hashCode

public int hashCode()

Retorna um código hash para este objeto Boolean.

Overrides:

hashCode in class Object

Returns:

o inteiro 1231 se este objeto representa true; retorna o inteiro 1237 se este objeto representa false.

See Also:

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

Retorna true se e apenas se o argumento não for null e for um objeto Boolean que representa o mesmo valor boolean deste objeto.

Overrides:

equals in class Object

Parameters:

obj - o objeto para comparar.

Returns:

true se os objetos Boolean representam o mesmo valor; false caso contrário.

See Also:

Object.hashCode(), Hashtable

getBoolean

public static boolean getBoolean(String name)

Retorna true se e apenas se a propriedade de sistema nomeada pelo argumento existe e é igual a string "true". (Iniciando com a versão 1.0.2 da plataforma Java^TM, o teste desta string é caso insensitivo.) Uma propriedade de sistema é acessível através de getProperty, um método definido pela classe System.

Se não existir a propriedade com o nome especificado, ou se o nome especificado for vazio ou nulo, então false é retornado.

Parameters:

name - o nome da propriedade do sistema.

Returns:

o valor boolean da propriedade de sistema.

See Also:

System.getProperty(java.lang.String), System.getProperty(java.lang.String, java.lang.String)

compareTo

public int compareTo(Boolean b)

Compara esta instância Boolean com uma outra.

Specified by:

compareTo in interface Comparable<Boolean>

Parameters:

b - a instância Boolean a ser comparada

Returns:

zero se este objeto representa o mesmo valor booleano que o argumento; um valor positivo se este objeto representa true e o argumento representa false; e um valor negativo se este objeto representa false e o argumento representa true

Throws:

NullPointerException - se o argumento for null

Since:

1.5

See Also:

Comparable