- java.lang.Object
-
- java.lang.Number
-
- java.lang.Byte
-
- 实现的所有接口
-
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
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 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
值,以数值方式将值视为无符号。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)
返回表示指定的byte
的新String
对象。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 。- 另请参见:
- 常数字段值
-
MAX_VALUE
public static final byte MAX_VALUE
持有byte
可以具有的最大值的常数,2 7 -1。- 另请参见:
- 常数字段值
-
SIZE
public static final int SIZE
用于表示二进制补码二进制形式的byte
值的位数。- 从以下版本开始:
- 1.5
- 另请参见:
- 常数字段值
-
BYTES
public static final int BYTES
用于表示二进制补码二进制形式的byte
值的字节数。- 从以下版本开始:
- 1.8
- 另请参见:
- 常数字段值
-
-
构造方法详细信息
-
Byte
@Deprecated(since="9") public Byte(byte value)
Deprecated.It is rarely appropriate to use this constructor. The static factoryvalueOf(byte)
is generally a better choice, as it is likely to yield significantly better space and time performance.构造一个新分配的Byte
对象,该对象表示指定的byte
值。- 参数
-
value
-值由表示Byte
。
-
Byte
@Deprecated(since="9") public Byte(String s) throws NumberFormatException
Deprecated.It is rarely appropriate to use this constructor. UseparseByte(String)
to convert a string to abyte
primitive, or usevalueOf(String)
to convert a string to aByte
object.构造一个新分配Byte
对象,表示byte
由指示值String
参数。 该字符串parseByte
方法用于基数10的方式转换为byte
值。- 参数
-
s
-的String
,以被转换为Byte
- 异常
-
NumberFormatException
- 如果String
不包含可分析的byte
。
-
-
方法详细信息
-
toString
public static String toString(byte b)
返回表示指定的byte
的新String
对象。 假设基数为10。- 参数
-
b
- 要转换的byte
- 结果
-
指定的
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
对象,保存字符串参数表示的值 - 异常
-
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)进行解析。 此字符序列必须表示正值或将抛出NumberFormatException
。 如果指定的String
第一个字符是减号,则结果为否定。String
中不允许使用空格字符。- 参数
-
nm
- 要解码的String
。 - 结果
-
Byte
对象,byte
值为nm
由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)
将此对象与指定的对象进行比较。 当且仅当参数不是null
并且是包含与此对象相同的byte
值的Byte
对象时,结果为true
。- 重写:
-
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
; 如果此Byte
在数值上大于参数Byte
(带符号的比较),则值大于0
。 - 从以下版本开始:
- 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
-
-