Class Byte

public static final byte MAX_VALUE

The maximum value a byte can represent is 127 (or 2⁷ - 1).

Field Value:

127

public static final byte MIN_VALUE

The minimum value a byte can represent is -128 (or -2⁷).

Field Value:

-128

public static final int SIZE

The number of bits needed to represent a byte.

Field Value:

8

Since:

1.5

public static final Class TYPE

The primitive type byte is represented by this Class object.

public Byte(byte value)

Create a Byte object representing the value of the byte argument.

Parameters:

value - the value to use

public Byte(String s)

Create a Byte object representing the value specified by the String argument

Parameters:

s - the string to convert

Throws:

NumberFormatException - if the String does not contain a byte

See Also:

valueOf(String)

public byte byteValue()

Return the value of this Byte.

Overrides:

byteValue in interface Number

Returns:

the byte value

public static int compare(byte x,
                          byte y)

Compares two unboxed byte values. The result is positive if the first is greater, negative if the second is greater, and 0 if the two are equal.

Parameters:

x - First value to compare.

y - Second value to compare.

Returns:

positive int if the first value is greater, negative if the second is greater, and 0 if the two are equal.

Since:

1.7

public int compareTo(Byte b)

Compare two Bytes numerically by comparing their byte values. The result is positive if the first is greater, negative if the second is greater, and 0 if the two are equal.

Parameters:

b - the Byte to compare

Returns:

the comparison

Since:

1.2

public static Byte decode(String s)

Convert the specified String into a Byte. The String may represent decimal, hexadecimal, or octal numbers.

The extended BNF grammar is as follows:

 DecodableString:
      ( [ - ] DecimalNumber )
    | ( [ - ] ( 0x | 0X
              | # ) { HexDigit }+ )
    | ( [ - ] 0 { OctalDigit } )
 DecimalNumber:
        DecimalDigit except '0' { DecimalDigit }
 DecimalDigit:
        Character.digit(d, 10) has value 0 to 9
 OctalDigit:
        Character.digit(d, 8) has value 0 to 7
 DecimalDigit:
        Character.digit(d, 16) has value 0 to 15
 

Finally, the value must be in the range MIN_VALUE to MAX_VALUE, or an exception is thrown.

Parameters:

s - the String to interpret

Returns:

the value of the String as a Byte

Throws:

NumberFormatException - if s cannot be parsed as a byte

NullPointerException - if s is null

See Also:

Integer.decode(String)

public double doubleValue()

Return the value of this Byte as a double.

Overrides:

doubleValue in interface Number

Returns:

the double value

public boolean equals(Object obj)

Returns true if obj is an instance of Byte and represents the same byte value.

Overrides:

equals in interface Object

Parameters:

obj - the object to compare

Returns:

whether these Objects are semantically equal

public float floatValue()

Return the value of this Byte as a float.

Overrides:

floatValue in interface Number

Returns:

the float value

public int hashCode()

Return a hashcode representing this Object. Byte's hash code is simply its value.

Overrides:

hashCode in interface Object

Returns:

this Object's hash code

public int intValue()

Return the value of this Byte as an int.

Overrides:

intValue in interface Number

Returns:

the int value

public long longValue()

Return the value of this Byte as a long.

Overrides:

longValue in interface Number

Returns:

the long value

public static byte parseByte(String s)

Converts the specified String into a byte. This function assumes a radix of 10.

Parameters:

s - the String to convert

Returns:

the byte value of s

Throws:

NumberFormatException - if s cannot be parsed as a byte

See Also:

parseByte(String)

public static byte parseByte(String s,
                             int radix)

Converts the specified String into an int using the specified radix (base). The string must not be null or empty. It may begin with an optional '-', which will negate the answer, provided that there are also valid digits. Each digit is parsed as if by Character.digit(d, radix), and must be in the range 0 to radix - 1. Finally, the result must be within MIN_VALUE to MAX_VALUE, inclusive. Unlike Double.parseDouble, you may not have a leading '+'.

Parameters:

s - the String to convert

radix - the radix (base) to use in the conversion

Returns:

the String argument converted to byte

Throws:

NumberFormatException - if s cannot be parsed as a byte

public short shortValue()

Return the value of this Byte as a short.

Overrides:

shortValue in interface Number

Returns:

the short value

public String toString()

Converts the Byte value to a String and assumes a radix of 10.

Overrides:

toString in interface Object

Returns:

the String representation of this Byte

See Also:

Integer.toString()

public static String toString(byte b)

Converts the byte to a String and assumes a radix of 10.

Parameters:

b - the byte to convert to String

Returns:

the String representation of the argument

public static Byte valueOf(byte val)

Returns a Byte object wrapping the value. In contrast to the Byte constructor, this method will cache some values. It is used by boxing conversion.

Parameters:

val - the value to wrap

Returns:

the Byte

public static Byte valueOf(String s)

Creates a new Byte object using the String, assuming a radix of 10.

Parameters:

s - the String to convert

Returns:

the new Byte

Throws:

NumberFormatException - if s cannot be parsed as a byte

See Also:

Byte(String), parseByte(String)

public static Byte valueOf(String s,
                           int radix)

Creates a new Byte object using the String and specified radix (base).

Parameters:

s - the String to convert

radix - the radix (base) to convert with

Returns:

the new Byte

Throws:

NumberFormatException - if s cannot be parsed as a byte

See Also:

parseByte(String,int)