- java.lang.Object
-
- java.lang.Number
-
- java.lang.Byte
-
- All Implemented Interfaces:
-
Serializable,Comparable<Byte>
public final class Byte extends Number implements Comparable<Byte>
Byte类包装一个对象中的原始类型byte的值。 类型为Byte的对象包含单个字段,其类型为byte。此外,该类还提供了多种将
byte转换为String和String转换为byte,以及在处理byte时有用的其他常数和方法。- 从以下版本开始:
- 1.1
- 另请参见:
-
Number, Serialized Form
-
-
构造方法摘要
构造方法 Constructor 描述 Byte(byte value)已过时。很少使用这个构造函数。 静态工厂valueOf(byte)通常是一个更好的选择,因为它可能产生明显更好的空间和时间性能。Byte(String s)已过时。很少使用这个构造函数。 使用parseByte(String)将字符串转换为byte原语,或使用valueOf(String)将字符串转换为Byte对象。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 bytebyteValue()返回Byte的值作为byte。static intcompare(byte x, byte y)数值比较两个byte。intcompareTo(Byte anotherByte)数字比较两个Byte对象。static intcompareUnsigned(byte x, byte y)将两个byte值进行比较,byte数值方式将值视为无符号。static Bytedecode(String nm)将String解码成Byte。doubledoubleValue()返回此值Byte为double一个宽元转换后。booleanequals(Object obj)将此对象与指定的对象进行比较。floatfloatValue()在扩展原始转换后,返回Byte的值作为float。inthashCode()返回这个Byte的哈希码; 等于调用intValue()的结果。static inthashCode(byte value)返回一个byte值的哈希码; 兼容Byte.hashCode()。intintValue()在扩展原始转换后,返回Byte的值作为int。longlongValue()返回此值Byte为long一个宽元转换后。static byteparseByte(String s)解析字符串参数为带符号的二进制byte。static byteparseByte(String s, int radix)将字符串参数解析为第二个参数指定的基数中的带符号的byte。shortshortValue()返回此值Byte为short一个宽元转换后。StringtoString()返回一个表示Byte的值的String对象。static StringtoString(byte b)返回一个新String表示指定对象byte。static inttoUnsignedInt(byte x)通过无符号转换将参数转换为int。static longtoUnsignedLong(byte x)通过无符号转换将参数转换为long。static BytevalueOf(byte b)返回表示byte值的Byte实例。static BytevalueOf(String s)返回一个Byte对象,保存由指定的String给出的值。static BytevalueOf(String s, int radix)返回一个Byte对象,该对象保存从指定的String提取的值,并使用第二个参数给出的基数进行解析。
-
-
-
字段详细信息
-
MIN_VALUE
public static final byte MIN_VALUE
一个常数保持最小值abyte可以有-2 -7 。- 另请参见:
- Constant Field Values
-
MAX_VALUE
public static final byte MAX_VALUE
一个持有最大值一个byte可以有2 7 -1。- 另请参见:
- Constant Field Values
-
SIZE
public static final int SIZE
用于表示二进制补码二进制形式的byte值的位数。- 从以下版本开始:
- 1.5
- 另请参见:
- Constant Field Values
-
BYTES
public static final int BYTES
用于表示二进制补码二进制形式的byte值的字节数。- 从以下版本开始:
- 1.8
- 另请参见:
- Constant Field Values
-
-
构造方法详细信息
-
Byte
@Deprecated(since="9") public Byte(byte value)
构造新分配的Byte对象,该对象表示指定的byte值。- 参数
-
value- 要由Byte表示的值。
-
Byte
@Deprecated(since="9") public Byte(String s) throws NumberFormatException
构造一个新分配的Byte对象,表示由String参数指示的byte值。 字符串转换为byte值,正好与基数为parseByte方法一样。- 参数
-
s-的String转换为一个Byte - 异常
-
NumberFormatException- 如果String不包含可解析的byte。
-
-
方法详细信息
-
toString
public static String toString(byte b)
返回一个新的String对象,代表指定的byte。 基数假定为10。- 参数
-
b- 要转换的byte - 结果
-
指定的字符串表示形式为
byte - 另请参见:
-
Integer.toString(int)
-
valueOf
public static Byte valueOf(byte b)
返回表示byte值的Byte实例。 如果不需要新的Byte实例,则该方法通常优先于构造函数Byte(byte)使用 ,因为所有字节值都被缓存,因此该方法可能会产生明显更好的空间和时间性能。- 参数
-
b- 一个字节值。 - 结果
-
一个
Byte实例,代表b。 - 从以下版本开始:
- 1.5
-
parseByte
public static byte parseByte(String s, int radix) throws NumberFormatException
将字符串参数解析为第二个参数指定的基数中的带符号的byte。 字符串中的字符必须全部是指定基数的数字(由Character.digit(char, int)是否返回非负值确定),除了第一个字符可能是ASCII减号'-'('\u002D')以指示负值或ASCII加号'+'('\u002B')以表示正值。 返回产生的byte值。如果发生以下任何一种情况,则抛出类型为
NumberFormatException的异常:- 第一个参数是
null或是长度为零的字符串。 - 基数小于
Character.MIN_RADIX或大于Character.MAX_RADIX。 - 字符串的任何字符不是指定基数的数字,除了第一个字符可能是负号
'-'('\u002D')或加号'+'('\u002B'),前提是字符串长于长度1。 - 由字符串表示的值不是
byte类型的值。
- 参数
-
s-所述String含有byte表示被解析 -
radix- 解析时使用的基数s - 结果
-
byte值由指定基数中的字符串参数表示 - 异常
-
NumberFormatException- 如果字符串不包含可解析的byte。
- 第一个参数是
-
parseByte
public static byte parseByte(String s) throws NumberFormatException
解析字符串参数为带符号的二进制byte。 字符串中的字符都必须是十进制数字,除了第一个字符可能是ASCII减号'-'('\u002D')以指示负值或ASCII加号'+'('\u002B')表示正值。 返回的结果为byte,就像参数和小数 10作为parseByte(java.lang.String, int)方法的参数一样 。- 参数
-
s- 一个String其中包含要解析的byte表示 - 结果
-
byte值由参数以十进制表示 - 异常
-
NumberFormatException- 如果字符串不包含可解析的byte。
-
valueOf
public static Byte valueOf(String s, int radix) throws NumberFormatException
返回一个Byte对象,该对象保存从指定的String提取的值,并使用第二个参数给出的基数进行解析。 第一个参数被解释为表示由第二个参数指定的基数中的带符号的byte,就像该参数被赋予parseByte(java.lang.String, int)方法一样。 结果是一个Byte对象,表示由字符串指定的byte值。换句话说,该方法返回一个
Byte对象的值等于:new Byte(Byte.parseByte(s, radix))- 参数
-
s- 要解析的字符串 -
radix- 用于解释的基数s - 结果
-
一个
Byte对象,其持有由指定基数中的字符串参数表示的值。 - 异常
-
NumberFormatException- 如果String不包含可解析的byte。
-
valueOf
public static Byte valueOf(String s) throws NumberFormatException
返回一个Byte对象,保存由指定的String给出的值。 该参数被解释为表示一个有符号的二进制byte,完全一样,这个参数被赋予了parseByte(java.lang.String)方法。 结果是一个Byte对象,表示由字符串指定的byte值。换句话说,此方法返回一个
Byte对象的值等于:new Byte(Byte.parseByte(s))- 参数
-
s- 要解析的字符串 - 结果
-
一个
Byte对象,保存由string参数表示的值 - 异常
-
NumberFormatException- 如果String不包含可解析的byte。
-
decode
public static Byte decode(String nm) throws NumberFormatException
将String解码为Byte。 接受以下语法给出的十进制,十六进制和八进制数:
DecimalNumeral,HexDigits,和OctalDigits如在The Java™ Language Specification 3.10.1部分所定义,所不同的是下划线不数字之间接受。- DecodableString:
- Signopt DecimalNumeral
-
Signopt
0xHexDigits -
Signopt
0XHexDigits -
Signopt
#HexDigits -
Signopt
0OctalDigits - Sign:
-
- -
+
可选符号和/或基数说明符(“
0x”,“0X”,“#”或前导零)之后的Byte.parseByte由具有指示的基数(10,16或8)的Byte.parseByte方法进行解析。 这个字符序列必须表示一个正值,或者会抛出一个NumberFormatException。 如果指定的String第一个字符为负号,则结果为否定。 在String中不允许使用空格字符。- 参数
-
nm-String进行解码。 - 结果
-
一个
Byte对象持有byte值代表nm - 异常
-
NumberFormatException- 如果String不包含可解析的byte。 - 另请参见:
-
parseByte(java.lang.String, int)
-
shortValue
public short shortValue()
返回此值Byte为short一个宽元转换后。- 重写:
-
shortValue在Number - 结果
-
该对象在转换为
short之后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
intValue
public int intValue()
在扩展原始转换后,返回Byte的值作为int。
-
longValue
public long longValue()
在扩展原始转换后,返回Byte的值作为long。
-
floatValue
public float floatValue()
返回此值Byte为float一个宽元转换后。- Specified by:
-
floatValue在Number - 结果
-
该对象在转换为
float之后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
doubleValue
public double doubleValue()
返回此值Byte为double一个宽元转换后。- Specified by:
-
doubleValue在Number - 结果
-
该对象在转换为
double之后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
toString
public String toString()
返回表示该Byte值的String对象。 该值将转换为带符号的十进制表示形式,并作为字符串返回,就像byte值作为toString(byte)方法的参数一样 。
-
hashCode
public int hashCode()
返回这个Byte的哈希码; 等于调用intValue()的结果。- 重写:
-
hashCode在类Object - 结果
-
一个哈希码值为这个
Byte - 另请参见:
-
Object.equals(java.lang.Object),System.identityHashCode(java.lang.Object)
-
hashCode
public static int hashCode(byte value)
返回一个byte值的哈希码; 兼容Byte.hashCode()。- 参数
-
value- 哈希值 - 结果
-
一个
byte值的哈希码值。 - 从以下版本开始:
- 1.8
-
equals
public boolean equals(Object obj)
将此对象与指定的对象进行比较。 结果是true当且仅当该参数不是null并且是一个Byte对象,其中包含与该对象相同的byte值。- 重写:
-
equals在类Object - 参数
-
obj- 与之比较的对象 - 结果
-
true如果对象是一样的;false否则。 - 另请参见:
-
Object.hashCode(),HashMap
-
compareTo
public int compareTo(Byte anotherByte)
数值比较两个Byte对象。- Specified by:
-
compareTo在接口Comparable<Byte> - 参数
-
anotherByte- 要比较的Byte。 - 结果
-
值
0如果这个Byte等于参数Byte; 小于0的值,如果这个Byte数值小于参数Byte; 和大于一个值0,如果这Byte在数值上大于该参数Byte(带符号的比较)。 - 从以下版本开始:
- 1.2
-
compare
public static int compare(byte x, byte y)数值比较两个byte数值。 返回的值与以下内容相同:Byte.valueOf(x).compareTo(Byte.valueOf(y))- 参数
-
x- 第一个byte进行比较 -
y- 第二个byte进行比较 - 结果
-
值
0如果是x == y; 一个值小于0如果是x < y; 和值大于0如果x > y - 从以下版本开始:
- 1.7
-
compareUnsigned
public static int compareUnsigned(byte x, byte y)比较两个byte值,以数值方式将值视为无符号。- 参数
-
x- 第一个byte进行比较 -
y- 第二个byte进行比较 - 结果
-
值
0如果是x == y; 如果x < y为无符号值,则小于0; 并且如果x > y为无符号值,则值大于0 - 从以下版本开始:
- 9
-
toUnsignedInt
public static int toUnsignedInt(byte x)
通过无符号转换将参数转换为int。 在无符号转换为一个int,所述的高阶24位int是零和低位8位都等于的比特byte参数。 因此,零和正值byte值被映射到数字上相等的int值,而负byte值被映射到等于输入加上2 8的int值。- 参数
-
x- 转换为无符号int的值 - 结果
-
该参数通过无符号转换转换为
int - 从以下版本开始:
- 1.8
-
toUnsignedLong
public static long toUnsignedLong(byte x)
通过无符号转换将参数转换为long。 在一个无符号转换为long,所述的高阶56位long是零和低位8位都等于的比特byte参数。 因此,零和正值byte值被映射到数字上相等的long值,负byte值被映射到等于输入加上2 8的long值。- 参数
-
x- 转换为无符号long的值 - 结果
-
该参数通过无符号转换转换为
long - 从以下版本开始:
- 1.8
-
-