- 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 方法 描述 byte
byteValue()
返回Byte
的值作为byte
。static int
compare(byte x, byte y)
数值比较两个byte
。int
compareTo(Byte anotherByte)
数字比较两个Byte
对象。static int
compareUnsigned(byte x, byte y)
将两个byte
值进行比较,byte
数值方式将值视为无符号。static Byte
decode(String nm)
将String
解码成Byte
。double
doubleValue()
返回此值Byte
为double
一个宽元转换后。boolean
equals(Object obj)
将此对象与指定的对象进行比较。float
floatValue()
在扩展原始转换后,返回Byte
的值作为float
。int
hashCode()
返回这个Byte
的哈希码; 等于调用intValue()
的结果。static int
hashCode(byte value)
返回一个byte
值的哈希码; 兼容Byte.hashCode()
。int
intValue()
在扩展原始转换后,返回Byte
的值作为int
。long
longValue()
返回此值Byte
为long
一个宽元转换后。static byte
parseByte(String s)
解析字符串参数为带符号的二进制byte
。static byte
parseByte(String s, int radix)
将字符串参数解析为第二个参数指定的基数中的带符号的byte
。short
shortValue()
返回此值Byte
为short
一个宽元转换后。String
toString()
返回一个表示Byte
的值的String
对象。static String
toString(byte b)
返回一个新String
表示指定对象byte
。static int
toUnsignedInt(byte x)
通过无符号转换将参数转换为int
。static long
toUnsignedLong(byte x)
通过无符号转换将参数转换为long
。static Byte
valueOf(byte b)
返回表示byte
值的Byte
实例。static Byte
valueOf(String s)
返回一个Byte
对象,保存由指定的String
给出的值。static Byte
valueOf(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
。 接受以下语法给出的十进制,十六进制和八进制数:- DecodableString:
- Signopt DecimalNumeral
-
Signopt
0x
HexDigits -
Signopt
0X
HexDigits -
Signopt
#
HexDigits -
Signopt
0
OctalDigits - 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
-
-