- 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
-
-
方法摘要
所有方法 静态方法 实例方法 具体的方法 变量和类型 方法 描述 bytebyteValue()返回此值Byte为byte。static intcompare(byte x, byte y)以数字方式比较两个byte值。intcompareTo(Byte anotherByte)以数字方式比较两个Byte对象。static intcompareUnsigned(byte x, byte y)比较两个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)返回表示指定的byte的新String对象。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 。- 另请参见:
- 常数字段值
-
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 abyteprimitive, or usevalueOf(String)to convert a string to aByteobject.构造一个新分配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。 接受以下语法给出的十进制,十六进制和八进制数:
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)进行解析。 此字符序列必须表示正值或将抛出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
-
-