public final class Byte
extends Number
implements Comparable<Byte>
java.lang.Object | ||
↳ | java.lang.Number | |
↳ | java.lang.Byte |
The Byte
class wraps a value of primitive type byte
in an object. An object of type Byte
contains a single field whose type is byte
.
In addition, this class provides several methods for converting a byte
to a String
and a String
to a byte
, as well as other constants and methods useful when dealing with a byte
.
See also:
Constants |
|
---|---|
int |
BYTES The number of bytes used to represent a |
byte |
MAX_VALUE A constant holding the maximum value a |
byte |
MIN_VALUE A constant holding the minimum value a |
int |
SIZE The number of bits used to represent a |
Fields |
|
---|---|
public static final Class<Byte> |
TYPE The |
Public constructors |
|
---|---|
Byte(byte value) Constructs a newly allocated |
|
Byte(String s) Constructs a newly allocated |
Public methods |
|
---|---|
byte |
byteValue() Returns the value of this |
static int |
compare(byte x, byte y) Compares two |
int |
compareTo(Byte anotherByte) Compares two |
static Byte |
decode(String nm) Decodes a |
double |
doubleValue() Returns the value of this |
boolean |
equals(Object obj) Compares this object to the specified object. |
float |
floatValue() Returns the value of this |
int |
hashCode() Returns a hash code for this |
static int |
hashCode(byte value) Returns a hash code for a |
int |
intValue() Returns the value of this |
long |
longValue() Returns the value of this |
static byte |
parseByte(String s) Parses the string argument as a signed decimal |
static byte |
parseByte(String s, int radix) Parses the string argument as a signed |
short |
shortValue() Returns the value of this |
String |
toString() Returns a |
static String |
toString(byte b) Returns a new |
static Byte |
valueOf(String s) Returns a |
static Byte |
valueOf(String s, int radix) Returns a |
static Byte |
valueOf(byte b) Returns a |
Inherited methods |
|
---|---|
![]() java.lang.Number
|
|
![]() java.lang.Object
|
|
![]() java.lang.Comparable
|
int BYTES
The number of bytes used to represent a byte
value in two's complement binary form.
Constant Value: 1 (0x00000001)
byte MAX_VALUE
A constant holding the maximum value a byte
can have, 27-1.
Constant Value: 127 (0x0000007f)
byte MIN_VALUE
A constant holding the minimum value a byte
can have, -27.
Constant Value: -128 (0xffffff80)
int SIZE
The number of bits used to represent a byte
value in two's complement binary form.
Constant Value: 8 (0x00000008)
Byte (byte value)
Constructs a newly allocated Byte
object that represents the specified byte
value.
Parameters | |
---|---|
value |
byte : the value to be represented by the Byte . |
Byte (String s)
Constructs a newly allocated Byte
object that represents the byte
value indicated by the String
parameter. The string is converted to a byte
value in exactly the manner used by the parseByte
method for radix 10.
Parameters | |
---|---|
s |
String : the String to be converted to a Byte |
Throws | |
---|---|
NumberFormatException |
If the String does not contain a parsable byte . |
See also:
byte byteValue ()
Returns the value of this Byte
as a byte
.
Returns | |
---|---|
byte |
the numeric value represented by this object after conversion to type byte . |
int compare (byte x, byte y)
Compares two byte
values numerically. The value returned is identical to what would be returned by:
Byte.valueOf(x).compareTo(Byte.valueOf(y))
Parameters | |
---|---|
x |
byte : the first byte to compare |
y |
byte : the second byte to compare |
Returns | |
---|---|
int |
the value 0 if x == y ; a value less than 0 if x < y ; and a value greater than 0 if x > y |
int compareTo (Byte anotherByte)
Compares two Byte
objects numerically.
Parameters | |
---|---|
anotherByte |
Byte : the Byte to be compared. |
Returns | |
---|---|
int |
the value 0 if this Byte is equal to the argument Byte ; a value less than 0 if this Byte is numerically less than the argument Byte ; and a value greater than 0 if this Byte is numerically greater than the argument Byte (signed comparison). |
Byte decode (String nm)
Decodes a String
into a Byte
. Accepts decimal, hexadecimal, and octal numbers given by the following grammar:
DecimalNumeral, HexDigits, and OctalDigits are as defined in section 3.10.1 of The Java™ Language Specification, except that underscores are not accepted between digits.
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits
- Sign:
-
+
The sequence of characters following an optional sign and/or radix specifier ("0x
", "0X
", "#
", or leading zero) is parsed as by the Byte.parseByte
method with the indicated radix (10, 16, or 8). This sequence of characters must represent a positive value or a NumberFormatException
will be thrown. The result is negated if first character of the specified String
is the minus sign. No whitespace characters are permitted in the String
.
Parameters | |
---|---|
nm |
String : the String to decode. |
Returns | |
---|---|
Byte |
a Byte object holding the byte value represented by nm |
Throws | |
---|---|
NumberFormatException |
if the String does not contain a parsable byte . |
See also:
double doubleValue ()
Returns the value of this Byte
as a double
.
Returns | |
---|---|
double |
the numeric value represented by this object after conversion to type double . |
boolean equals (Object obj)
Compares this object to the specified object. The result is true
if and only if the argument is not null
and is a Byte
object that contains the same byte
value as this object.
Parameters | |
---|---|
obj |
Object : the object to compare with |
Returns | |
---|---|
boolean |
true if the objects are the same; false otherwise. |
float floatValue ()
Returns the value of this Byte
as a float
.
Returns | |
---|---|
float |
the numeric value represented by this object after conversion to type float . |
int hashCode ()
Returns a hash code for this Byte
; equal to the result of invoking intValue()
.
Returns | |
---|---|
int |
a hash code value for this Byte |
int hashCode (byte value)
Returns a hash code for a byte
value; compatible with Byte.hashCode()
.
Parameters | |
---|---|
value |
byte : the value to hash |
Returns | |
---|---|
int |
a hash code value for a byte value. |
int intValue ()
Returns the value of this Byte
as an int
.
Returns | |
---|---|
int |
the numeric value represented by this object after conversion to type int . |
long longValue ()
Returns the value of this Byte
as a long
.
Returns | |
---|---|
long |
the numeric value represented by this object after conversion to type long . |
byte parseByte (String s)
Parses the string argument as a signed decimal byte
. The characters in the string must all be decimal digits, except that the first character may be an ASCII minus sign '-'
('\u002D'
) to indicate a negative value or an ASCII plus sign '+'
('\u002B'
) to indicate a positive value. The resulting byte
value is returned, exactly as if the argument and the radix 10 were given as arguments to the parseByte(java.lang.String, int)
method.
Parameters | |
---|---|
s |
String : a String containing the byte representation to be parsed |
Returns | |
---|---|
byte |
the byte value represented by the argument in decimal |
Throws | |
---|---|
NumberFormatException |
if the string does not contain a parsable byte . |
byte parseByte (String s, int radix)
Parses the string argument as a signed byte
in the radix specified by the second argument. The characters in the string must all be digits, of the specified radix (as determined by whether digit(char, int)
returns a nonnegative value) except that the first character may be an ASCII minus sign '-'
('\u002D'
) to indicate a negative value or an ASCII plus sign '+'
('\u002B'
) to indicate a positive value. The resulting byte
value is returned.
An exception of type NumberFormatException
is thrown if any of the following situations occurs:
null
or is a string of length zero. MIN_RADIX
or larger than MAX_RADIX
. '-'
('\u002D'
) or plus sign '+'
('\u002B'
) provided that the string is longer than length 1. byte
. Parameters | |
---|---|
s |
String : the String containing the byte representation to be parsed |
radix |
int : the radix to be used while parsing s |
Returns | |
---|---|
byte |
the byte value represented by the string argument in the specified radix |
Throws | |
---|---|
NumberFormatException |
If the string does not contain a parsable byte . |
short shortValue ()
Returns the value of this Byte
as a short
.
Returns | |
---|---|
short |
the numeric value represented by this object after conversion to type short . |
String toString ()
Returns a String
object representing this Byte
's value. The value is converted to signed decimal representation and returned as a string, exactly as if the byte
value were given as an argument to the toString(byte)
method.
Returns | |
---|---|
String |
a string representation of the value of this object in base 10. |
String toString (byte b)
Returns a new String
object representing the specified byte
. The radix is assumed to be 10.
Parameters | |
---|---|
b |
byte : the byte to be converted |
Returns | |
---|---|
String |
the string representation of the specified byte |
See also:
Byte valueOf (String s)
Returns a Byte
object holding the value given by the specified String
. The argument is interpreted as representing a signed decimal byte
, exactly as if the argument were given to the parseByte(java.lang.String)
method. The result is a Byte
object that represents the byte
value specified by the string.
In other words, this method returns a Byte
object equal to the value of:
new Byte(Byte.parseByte(s))
Parameters | |
---|---|
s |
String : the string to be parsed |
Returns | |
---|---|
Byte |
a Byte object holding the value represented by the string argument |
Throws | |
---|---|
NumberFormatException |
If the String does not contain a parsable byte . |
Byte valueOf (String s, int radix)
Returns a Byte
object holding the value extracted from the specified String
when parsed with the radix given by the second argument. The first argument is interpreted as representing a signed byte
in the radix specified by the second argument, exactly as if the argument were given to the parseByte(java.lang.String, int)
method. The result is a Byte
object that represents the byte
value specified by the string.
In other words, this method returns a Byte
object equal to the value of:
new Byte(Byte.parseByte(s, radix))
Parameters | |
---|---|
s |
String : the string to be parsed |
radix |
int : the radix to be used in interpreting s |
Returns | |
---|---|
Byte |
a Byte object holding the value represented by the string argument in the specified radix. |
Throws | |
---|---|
NumberFormatException |
If the String does not contain a parsable byte . |
Byte valueOf (byte b)
Returns a Byte
instance representing the specified byte
value. If a new Byte
instance is not required, this method should generally be used in preference to the constructor Byte(byte)
, as this method is likely to yield significantly better space and time performance since all byte values are cached.
Parameters | |
---|---|
b |
byte : a byte value. |
Returns | |
---|---|
Byte |
a Byte instance representing b . |