|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.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 FormField 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
byte
Integer.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
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits
- 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 Number
byte
.public short shortValue()
Byte
as a
short
.
shortValue
in class Number
short
.public int intValue()
Byte
as an
int
.
intValue
in class Number
int
.public long longValue()
Byte
as a
long
.
longValue
in class Number
long
.public float floatValue()
Byte
as a
float
.
floatValue
in class Number
float
.public double doubleValue()
Byte
as a
double
.
doubleValue
in class Number
double
.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 Object
public int hashCode()
Byte
.
hashCode
in class Object
Object.equals(java.lang.Object)
,
Hashtable
public 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 Object
obj
- the object to compare with
true
if the objects are the same;
false
otherwise.Object.hashCode()
,
Hashtable
public 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 © 1993, 2010, Oracle and/or its affiliates. All rights reserved.