Byte (Java 2 Platform SE 5.0)

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.

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Standard Ed. 5.0

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

java.lang
Class Byte

java.lang.Object
  java.lang.Number
      java.lang.Byte

All Implemented Interfaces:: Serializable, Comparable<Byte>

public final class Byte
extends Number
implements Comparable<Byte>
extends Number
implements Comparable<Byte>

A classe Byte empacota um valor do tipo primitivo byte em um objeto. Um objeto do tipo Byte contém um campo simples cujo tipo é byte.

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

Since:: JDK1.1
See Also:: Number, Serialized Form

Field Summary
`static byte`	`MAX_VALUE` Uma constante mantendo o valor máximo que um `byte` pode ter, 2⁷-1.
`static byte`	`MIN_VALUE` Uma constante mantendo o valor mínimo que um `byte` pode ter, -2⁷.
`static int`	`SIZE` O número de bits usados para representar um valor `byte` value na forma binária de complemento de dois.
`static Class<Byte>`	`TYPE` A instância `Class` representando o tipo primitivo `byte`.

Constructor Summary
`Byte(byte value)` Constrói um objeto `Byte` recentemente alocado que representa o valor `byte` especificado.
`Byte(String s)` Constrói um objeto `Byte` recentemente alocado que representa o valor `byte` indicado pelo parâmetro `String`.

Method Summary
`byte`	`byteValue()` Retorna o valor deste `Byte` como um `byte`.
`int`	`compareTo(Byte anotherByte)` Compara dois objetos `Byte` numericamente.
`static Byte`	`decode(String nm)` Decodifica uma `String` em um `Byte`.
`double`	`doubleValue()` Retorna o valor deste `Byte` como um `double`.
`boolean`	`equals(Object obj)` Compara este objeto com o objeto especificado.
`float`	`floatValue()` Retorna o valor deste `Byte` como um `float`.
`int`	`hashCode()` Retorna o código hash para este `Byte`.
`int`	`intValue()` Retorna o valor deste `Byte` como um `int`.
`long`	`longValue()` Retorna o valor deste `Byte` como um `long`.
`static byte`	`parseByte(String s)` Analisa o argumento string como o um `byte` decimal com sinal.
`static byte`	`parseByte(String s, int radix)` Analisa o argumento string argument como um `byte` com sinal na base especificada pelo segundo argumento.
`short`	`shortValue()` Retorna o valor deste `Byte` como um `short`.
`String`	`toString()` Retorna um objeto `String` representando o valor deste `Byte`.
`static String`	`toString(byte b)` Retorna um novo objeto `String` representando o `byte` especificado.
`static Byte`	`valueOf(byte b)` Retorna uma instância de `Byte` representando o valor `byte` especificado.
`static Byte`	`valueOf(String s)` Retorna um objeto `Byte` mantendo o valor fornecido pela `String` especificada.
`static Byte`	`valueOf(String s, int radix)` Retorna um objeto `Byte` mantendo o valor extraído da `String` especificada quando analisada com a base fornecida pelo segundo argumento.

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Field Detail

MIN_VALUE

public static final byte MIN_VALUE

Uma constante mantendo o valor mínimo que um byte pode ter, -2⁷.

See Also:: Constant Field Values

MAX_VALUE

public static final byte MAX_VALUE

Uma constante mantendo o valor máximo que um byte pode ter, 2⁷-1.

See Also:: Constant Field Values

TYPE

public static final Class<Byte> TYPE

A instância Class representando o tipo primitivo byte.

SIZE

public static final int SIZE

O número de bits usados para representar um valor byte value na forma binária de complemento de dois.

Since:: 1.5
See Also:: Constant Field Values

Constructor Detail

Byte

public Byte(byte value)

Constrói um objeto Byte recentemente alocado que representa o valor byte especificado.

Parameters:: value - o valor a ser representado pelo Byte.

Byte

public Byte(String s)
     throws NumberFormatException

Constrói um objeto Byte recentemente alocado que representa o valor byte indicado pelo parâmetro String. A string é convertida para um valor byte exatamente da maneira usada pelo método parseByte para a base 10.

Parameters:: s - a String a ser convertida para um Byte
Throws:: NumberFormatException - Se a String não contém um byte que possa ser analisado.
See Also:: parseByte(java.lang.String, int)

Method Detail

toString

public static String toString(byte b)

Retorna um novo objeto String representando o byte especificado. A base 10 é assumida.

Parameters:: b - o byte a ser convertido
Returns:: a representação string do byte especificado
See Also:: Integer.toString(int)

valueOf

public static Byte valueOf(byte b)

Retorna uma instância de Byte representando o valor byte especificado. Se uma nova instância de Byte não for solicitada, este método deveria normalmente ser usado em preferência ao construtor Byte(byte), assim este método é apropriado para dar desempenho de tempo e espaço significantemente melhor armazenando em cache valores solicitados frequentemente.

Parameters:: b - um valor byte.
Returns:: uma instância de Byte representando b.
Since:: 1.5

parseByte

public static byte parseByte(String s)
                      throws NumberFormatException

Analisa o argumento string como o um byte decimal com sinal. Os caracteres na string devem todos ser dígitos decimais, exceto o primeiro que pode ser um sinal de menos '-' ('\u002D') para indicar um valor negativo. O valor byte resultante é retornado, exatamente como se o argumento e a base 10 fossem dados como argumentos para o método

parseByte(java.lang.String,
 int)

Parameters:: s - uma String contendo a representação byte a ser analisada
Returns:: o valor byte representado pelo argument em decimal
Throws:: NumberFormatException - se a string não contém um byte que possa ser analisado.

parseByte

public static byte parseByte(String s,
                             int radix)
                      throws NumberFormatException

Analisa o argumento string argument como um byte com sinal na base especificada pelo segundo argumento. Os caracteres na string devem todos ser dígitos, da base especificada (como determinado pelo

Character.digit(char,
 int)

se retorna um valor não negativo) exceto o primeiro caracter que pode ser um sinal de menos '-' ('\u002D') para indicar um valor negativo. O valor byte resultante é retornado.

Uma exceção do tipo NumberFormatException é lançada se qualquer das seguintes situações ocorrer:

O primeiro argumento é null ou é uma string de tamanho zero.
A base é menor do que Character.MIN_RADIX ou maior do que Character.MAX_RADIX.
Qualquer caracer da string não for um dígito da base especificada, exceto o primeiro caracter que pode ser um sinal de menos '-' ('\u002D') fornecido por uma string que tem tamanho maior do que 1.
O valor representado pela string não é um valor do tipo byte.

Parameters:: s - a String contendo a representação byte a ser analisada; radix - a base a ser usada enquanto analisando o valor
Returns:: byte de s representado pelo argumento string na base especificada
Throws:: NumberFormatException - Se a string não contém um byte que possa ser analisado.

valueOf

public static Byte valueOf(String s,
                           int radix)
                    throws NumberFormatException

Retorna um objeto Byte mantendo o valor extraído da String especificada quando analisada com a base fornecida pelo segundo argumento. O primeiro argumento é interpretado como representando um byte com sinal na base especificada pelo segundo argumento, exatamente como se o argumento fosse fornecido para o método

parseByte(java.lang.String,
 int)

. O resultado é um objeto Byte que representa o valor byte especificado pela string.

Em outras palavras, este método retorna um objeto Byte igual ao valor de:

new Byte(Byte.parseByte(s, radix))

Parameters:: s - a string a ser analisada; radix - a base a ser usada na interpretação de s
Returns:: como um objeto Byte mantendo o valor representado pelo argumento string na base especificada.
Throws:: NumberFormatException - Se a String não contém um byte que possa ser analisado.

valueOf

public static Byte valueOf(String s)
                    throws NumberFormatException

Retorna um objeto Byte mantendo o valor fornecido pela String especificada. O argumente é interpretado como representando um byte decimal com sinal, exatamente como se o argumento fosse fornecido para o método . O resultado é um objeto Byte que representa o valor byte especificado pela string.

Em outras palavaras, este método retorna um objeto Byte igual ao valor de:

new Byte(Byte.parseByte(s))

Parameters:: s - a string a ser analisada
Returns:: um objeto Byte mantendo o valor representado pelo argumento string
Throws:: NumberFormatException - Se a String não contém um byte que possa ser analisado.

decode

public static Byte decode(String nm)
                   throws NumberFormatException

Decodifica uma String em um Byte. Aceita números decimais, hexadecimais, e octais fornecidos pela seguinte gramática:

String Decodificável:
Sinal_opcional Números Decimais
Sinal_opcional 0x Dígitos Hexa
Sinal_opcional 0X Dígitos Hexa
Sinal_opcional # Dígitos Hexa
Sinal_opcional 0 Dígitos Octais

Sinal:
-

Números Decimais, Dígitos Hexa, e Dígitos Octais estão definicidos em §3.10.1 da Especificação da Liguagem Java.

A seqûência de caracteres seguindo de um sinal negativo (opcional) e/ou o especificador de base ("0x", "0X", "#", ou apenas zero) é analisada pelo método Byte.parseByte com a base (10, 16, or 8) indicada. Estas seqüências de caracteres deve representar um valor positivo ou um NumberFormatException será lançado. O resultado é negado se o primeiro caracter da String especificada for o sinal de menos. Nenhum caracter de espaço em branco é permitido na String.

Parameters:: nm - a String para decodificar.
Returns:: um objeto Byte mantendo o valor byte representado por nm
Throws:: NumberFormatException - se a String não contém um byte que possa ser analisado.
See Also:: parseByte(java.lang.String, int)

byteValue

public byte byteValue()

Retorna o valor deste Byte como um byte.

Overrides:: byteValue in class Number

Returns:: the numeric value represented by this object after conversion to type byte.

shortValue

public short shortValue()

Retorna o valor deste Byte como um short.

Overrides:: shortValue in class Number

Returns:: the numeric value represented by this object after conversion to type short.

intValue

public int intValue()

Retorna o valor deste Byte como um int.

Specified by:: intValue in class Number

Returns:: the numeric value represented by this object after conversion to type int.

longValue

public long longValue()

Retorna o valor deste Byte como um long.

Specified by:: longValue in class Number

Returns:: the numeric value represented by this object after conversion to type long.

floatValue

public float floatValue()

Retorna o valor deste Byte como um float.

Specified by:: floatValue in class Number

Returns:: the numeric value represented by this object after conversion to type float.

doubleValue

public double doubleValue()

Retorna o valor deste Byte como um double.

Specified by:: doubleValue in class Number

Returns:: the numeric value represented by this object after conversion to type double.

toString

public String toString()

Retorna um objeto String representando o valor deste Byte. O valor é convertido para a representação de decimal com sinal e retornado como uma string, exatamente como se o valor byte fosse dado como um argumento para o método toString(byte).

Overrides:: toString in class Object

Returns:: uma representação string do valor deste objeto na base 10.

hashCode

public int hashCode()

Retorna o código hash para este Byte.

Overrides:: hashCode in class Object

Returns:: a hash code value for this object.
See Also:: Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

Compara este objeto com o objeto especificado. O resultado é true se e apenas se o argumento não for null e for um objeto Byte que contém o mesmo valor byte deste objeto.

Overrides:: equals in class Object

Parameters:: obj - o objeto a ser comparado
Returns:: true se os objetos são os mesmo; false caso contrário.
See Also:: Object.hashCode(), Hashtable

compareTo

public int compareTo(Byte anotherByte)

Compara dois objetos Byte numericamente.

Specified by:: compareTo in interface Comparable<Byte>

Parameters:: anotherByte - o Byte a ser comparado.
Returns:: o valor 0 se este Byte for igual ao argumento Byte; um valor menor do que 0 se este Byte for numericamente menor do que o argumento Byte; e um valor maior do que 0 se este Byte for numericamente maior do que o argumento Byte (comparação com sinal).
Since:: 1.2

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Standard Ed. 5.0

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

java.lang Class Byte

MIN_VALUE

MAX_VALUE

TYPE

SIZE

Byte

Byte

toString

valueOf

parseByte

parseByte

valueOf

valueOf

decode

byteValue

shortValue

intValue

longValue

floatValue

doubleValue

toString

hashCode

equals

compareTo

java.lang
Class Byte