|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.lang.Number
java.lang.Byte
public final class 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.
Number,
Serialized Form| Field Summary | |
|---|---|
static byte |
MAX_VALUE
A constant holding the maximum value a byte can
have, 27-1. |
static byte |
MIN_VALUE
A constant holding the minimum value a byte can
have, -27. |
static int |
SIZE
The number of bits used to represent a byte value in two's complement binary form. |
static Class<Byte> |
TYPE
The Class instance representing the primitive type
byte. |
| Constructor Summary | |
|---|---|
Byte(byte value)
Constructs a newly allocated Byte object that
represents the specified byte value. |
|
Byte(String s)
Constructs a newly allocated Byte object that
represents the byte value indicated by the
String parameter. |
|
| Method Summary | |
|---|---|
byte |
byteValue()
Returns the value of this Byte as a
byte. |
int |
compareTo(Byte anotherByte)
Compares two Byte objects numerically. |
static Byte |
decode(String nm)
Decodes a String into a Byte. |
double |
doubleValue()
Returns the value of this Byte as a
double. |
boolean |
equals(Object obj)
Compares this object to the specified object. |
float |
floatValue()
Returns the value of this Byte as a
float. |
int |
hashCode()
Returns a hash code for this Byte. |
int |
intValue()
Returns the value of this Byte as an
int. |
long |
longValue()
Returns the value of this Byte as a
long. |
static byte |
parseByte(String s)
Parses the string argument as a signed decimal byte. |
static byte |
parseByte(String s,
int radix)
Parses the string argument as a signed byte in the
radix specified by the second argument. |
short |
shortValue()
Returns the value of this Byte as a
short. |
String |
toString()
Returns a String object representing this
Byte's value. |
static String |
toString(byte b)
Returns a new String object representing the
specified byte. |
static Byte |
valueOf(byte b)
Returns a Byte instance representing the specified byte value. |
static Byte |
valueOf(String s)
Returns a Byte object holding the value
given by the specified String. |
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. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
public static final byte MIN_VALUE
byte can
have, -27.
public static final byte MAX_VALUE
byte can
have, 27-1.
public static final Class<Byte> TYPE
Class instance representing the primitive type
byte.
public static final int SIZE
| Constructor Detail |
|---|
public Byte(byte value)
Byte object that
represents the specified byte value.
value - the value to be represented by the
Byte.
public Byte(String s)
throws NumberFormatException
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.
s - the String to be converted to a
Byte
NumberFormatException - If the String
does not contain a parsable byte.parseByte(java.lang.String, int)| Method Detail |
|---|
public static String toString(byte b)
String object representing the
specified byte. The radix is assumed to be 10.
b - the byte to be converted
byteInteger.toString(int)public static Byte valueOf(byte b)
Byte(byte), as this method is likely to yield
significantly better space and time performance by caching
frequently requested values.
b - a byte value.
public static byte parseByte(String s)
throws NumberFormatException
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. 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.
s - a String containing the
byte representation to be parsed
byte value represented by the
argument in decimal
NumberFormatException - if the string does not
contain a parsable byte.
public static byte parseByte(String s,
int radix)
throws NumberFormatException
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 Character.digit(char,
int) returns a nonnegative value) except that the first
character may be an ASCII minus sign '-'
('\u002D') to indicate a negative 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.
Character.MIN_RADIX or larger than Character.MAX_RADIX.
'-' ('\u002D') provided that the
string is longer than length 1.
byte.
s - the String containing the
byte
representation to be parsedradix - the radix to be used while parsing s
byte value represented by the string
argument in the specified radix
NumberFormatException - If the string does
not contain a parsable byte.
public static Byte valueOf(String s,
int radix)
throws NumberFormatException
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))
s - the string to be parsedradix - the radix to be used in interpreting s
Byte object holding the value
represented by the string argument in the
specified radix.
NumberFormatException - If the String does
not contain a parsable byte.
public static Byte valueOf(String s)
throws NumberFormatException
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))
s - the string to be parsed
Byte object holding the value
represented by the string argument
NumberFormatException - If the String does
not contain a parsable byte.
public static Byte decode(String nm)
throws NumberFormatException
String into a Byte.
Accepts decimal, hexadecimal, and octal numbers given by
the following grammar:
DecimalNumeral, HexDigits, and OctalDigits are defined in §3.10.1 of the Java Language Specification.
- DecodableString:
- Signopt DecimalNumeral
- Signopt
0xHexDigits- Signopt
0XHexDigits- Signopt
#HexDigits- Signopt
0OctalDigits
- Sign:
-
The sequence of characters following an (optional) negative
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.
nm - the String to decode.
Byte object holding the byte
value represented by nm
NumberFormatException - if the String does not
contain a parsable byte.parseByte(java.lang.String, int)public byte byteValue()
Byte as a
byte.
byteValue in class Numberbyte.public short shortValue()
Byte as a
short.
shortValue in class Numbershort.public int intValue()
Byte as an
int.
intValue in class Numberint.public long longValue()
Byte as a
long.
longValue in class Numberlong.public float floatValue()
Byte as a
float.
floatValue in class Numberfloat.public double doubleValue()
Byte as a
double.
doubleValue in class Numberdouble.public String toString()
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.
toString in class Objectpublic int hashCode()
Byte.
hashCode in class ObjectObject.equals(java.lang.Object),
Hashtablepublic boolean equals(Object obj)
true if and only if the argument is not
null and is a Byte object that
contains the same byte value as this object.
equals in class Objectobj - the object to compare with
true if the objects are the same;
false otherwise.Object.hashCode(),
Hashtablepublic int compareTo(Byte anotherByte)
Byte objects numerically.
compareTo in interface Comparable<Byte>anotherByte - the Byte to be compared.
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).
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.