| |
|
| java.lang.Object
 java.lang.Number
java.lang.Byte
| Byte | | final public class Byte extends Number implements Comparable<Byte>(Code) | | 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 .
author:
Nakul Saraiya
author:
Joseph D. Darcy
version:
1.49, 05/05/07
See Also: java.lang.Number
since:
JDK1.1 |
| Field Summary | |
| final public static byte | MAX_VALUE
A constant holding the maximum value a
byte can
have, 27-1. | | final public static byte | MIN_VALUE
A constant holding the minimum value a
byte can
have, -27. | | final public static int | SIZE
The number of bits used to represent a
byte value in two's
complement binary form. | | final public static Class<Byte> | TYPE
The
Class instance representing the primitive type
byte . |
| Constructor Summary | |
| public | Byte(byte value)
Constructs a newly allocated
Byte object that
represents the specified
byte value. | | public | Byte(String s)
Constructs a newly allocated
Byte object that
represents the
byte value indicated by the
String parameter. |
| Method Summary | |
| public byte | byteValue()
Returns the value of this
Byte as a
byte . | | public int | compareTo(Byte anotherByte)
Compares two
Byte objects numerically. | | public static Byte | decode(String nm)
Decodes a
String into a
Byte .
Accepts decimal, hexadecimal, and octal numbers given by
the following grammar:
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x HexDigits
- Signopt
0X HexDigits
- Signopt
# HexDigits
- Signopt
0 OctalDigits
- Sign:
-
-
-
+
DecimalNumeral, HexDigits, and OctalDigits
are defined in §3.10.1
of the Java
Language Specification.
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. | | public double | doubleValue()
Returns the value of this
Byte as a
double . | | public boolean | equals(Object obj)
Compares this object to the specified object. | | public float | floatValue()
Returns the value of this
Byte as a
float . | | public int | hashCode()
Returns a hash code for this
Byte . | | public int | intValue()
Returns the value of this
Byte as an
int . | | public long | longValue()
Returns the value of this
Byte as a
long . | | public static byte | parseByte(String s, int radix)
Parses the string argument as a signed
byte in the
radix specified by the second argument. | | public static byte | parseByte(String s)
Parses the string argument as a signed decimal
byte . | | public short | shortValue()
Returns the value of this
Byte as a
short . | | public static String | toString(byte b)
Returns a new
String object representing the
specified
byte . | | public String | toString()
Returns a
String object representing this
Byte 's value. | | public static 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(byte) , as this method is likely to yield
significantly better space and time performance by caching
frequently requested values.
Parameters:
b - a byte value. | | public static 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. | | public static Byte | valueOf(String s)
Returns a
Byte object holding the value
given by the specified
String . |
| MAX_VALUE | | final public static byte MAX_VALUE(Code) | | A constant holding the maximum value a
byte can
have, 27-1.
|
| MIN_VALUE | | final public static byte MIN_VALUE(Code) | | A constant holding the minimum value a
byte can
have, -27.
|
| SIZE | | final public static int SIZE(Code) | | The number of bits used to represent a
byte value in two's
complement binary form.
since:
1.5 |
| TYPE | | final public static Class<Byte> TYPE(Code) | | The
Class instance representing the primitive type
byte .
|
| Byte | | public Byte(byte value)(Code) | | Constructs a newly allocated
Byte object that
represents the specified
byte value.
Parameters:
value - the value to be represented by the Byte . |
| byteValue | | public byte byteValue()(Code) | | Returns the value of this
Byte as a
byte .
|
| compareTo | | public int compareTo(Byte anotherByte)(Code) | | Compares two
Byte objects numerically.
Parameters:
anotherByte - the Byte to be compared. the value 0 if this Byte isequal to the argument Byte ; a value less than 0 if this Byte is numerically lessthan the argument Byte ; and a value greater than 0 if this Byte is numericallygreater than the argument Byte (signedcomparison).
since:
1.2 |
| decode | | public static Byte decode(String nm) throws NumberFormatException(Code) | | Decodes a
String into a
Byte .
Accepts decimal, hexadecimal, and octal numbers given by
the following grammar:
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x HexDigits
- Signopt
0X HexDigits
- Signopt
# HexDigits
- Signopt
0 OctalDigits
- Sign:
-
-
-
+
DecimalNumeral, HexDigits, and OctalDigits
are defined in §3.10.1
of the Java
Language Specification.
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 - the String to decode. a Byte object holding the byte value represented by nm
throws:
NumberFormatException - if the String does notcontain a parsable byte .
See Also: java.lang.Byte.parseByte(java.lang.Stringint) |
| doubleValue | | public double doubleValue()(Code) | | Returns the value of this
Byte as a
double .
|
| equals | | public boolean equals(Object obj)(Code) | | 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 - the object to compare with true if the objects are the same; false otherwise. |
| floatValue | | public float floatValue()(Code) | | Returns the value of this
Byte as a
float .
|
| hashCode | | public int hashCode()(Code) | | Returns a hash code for this
Byte .
|
| intValue | | public int intValue()(Code) | | Returns the value of this
Byte as an
int .
|
| longValue | | public long longValue()(Code) | | Returns the value of this
Byte as a
long .
|
| parseByte | | public static byte parseByte(String s, int radix) throws NumberFormatException(Code) | | 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
java.lang.Character.digit(charint) 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:
- The first argument is
null or is a string of
length zero.
- The radix is either smaller than
java.lang.Character.MIN_RADIX or larger than
java.lang.Character.MAX_RADIX .
- Any character of the string is not a digit of the
specified radix, except that the first character may be a minus
sign
'-' (
'\u002D') or plus sign
'+' ('\u002B') provided that the
string is longer than length 1.
- The value represented by the string is not a value of type
byte .
Parameters:
s - the String containing the byte representation to be parsed
Parameters:
radix - the radix to be used while parsing s the byte value represented by the string argument in the specified radix
throws:
NumberFormatException - If the string doesnot contain a parsable byte . |
| parseByte | | public static byte parseByte(String s) throws NumberFormatException(Code) | | 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
Byte.parseByte(java.lang.String,int) method.
Parameters:
s - a String containing the byte representation to be parsed the byte value represented by the argument in decimal
throws:
NumberFormatException - if the string does notcontain a parsable byte . |
| shortValue | | public short shortValue()(Code) | | Returns the value of this
Byte as a
short .
|
| toString | | public static String toString(byte b)(Code) | | Returns a new
String object representing the
specified
byte . The radix is assumed to be 10.
Parameters:
b - the byte to be converted the string representation of the specified byte
See Also: java.lang.Integer.toString(int) |
| toString | | public String toString()(Code) | | 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
java.lang.Byte.toString(byte) method.
a string representation of the value of this object inbase 10. |
| valueOf | | public static Byte valueOf(byte b)(Code) | | 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(byte) , as this method is likely to yield
significantly better space and time performance by caching
frequently requested values.
Parameters:
b - a byte value. a Byte instance representing b .
since:
1.5 |
| valueOf | | public static Byte valueOf(String s, int radix) throws NumberFormatException(Code) | | 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
Byte.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 - the string to be parsed
Parameters:
radix - the radix to be used in interpreting s 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 . |
| valueOf | | public static Byte valueOf(String s) throws NumberFormatException(Code) | | 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
Byte.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 - the string to be parsed a Byte object holding the valuerepresented by the string argument
throws:
NumberFormatException - If the String doesnot contain a parsable byte . |
|
|
|