鸿蒙OS Byte

Byte

java.lang.Object

|—java.lang.Number

|—|—java.lang.Byte

public final class Byte
extends Number
implements Comparable<Byte>

Byte 类将原始类型 byte 的值包装在一个对象中。 Byte 类型的对象包含一个类型为 byte 的字段。

此外,该类提供了几种将字节转换为字符串和将字符串转换为字节的方法,以及在处理字节时有用的其他常量和方法。

字段摘要

修饰符和类型 字段 描述
static int BYTES 用于以二进制补码形式表示字节值的字节数。
static byte MAX_VALUE 一个保持字节可以具有的最大值的常量,27-1。
static byte MIN_VALUE 一个保持字节可以具有的最小值的常量,-27。
static int SIZE 用于以二进制补码形式表示字节值的位数。
static ClassByte TYPE 表示原始类型字节的 Class 实例。

构造函数摘要

构造函数 描述
Byte(byte value) 构造一个新分配的 Byte 对象,该对象表示指定的字节值。
Byte(String s) 构造一个新分配的 Byte 对象,该对象表示由 String 参数指示的字节值。

方法总结

修饰符和类型 方法 描述
byte byteValue() 以字节形式返回此 Byte 的值。
static int compare(byte x, byte y) 以数字方式比较两个字节值。
int compareTo(Byte anotherByte) 以数字方式比较两个 Byte 对象。
static Byte decode(String nm) 将字符串解码为字节。
double doubleValue() 在扩大原始转换后,将此 Byte 的值作为双精度值返回。
boolean equals(Object obj) 将此对象与指定对象进行比较。
float floatValue() 在扩大基元转换后,将此 Byte 的值作为浮点数返回。
int hashCode() 返回此字节的哈希码; 等于调用 intValue() 的结果。
static int hashCode(byte value) 返回字节值的哈希码; 与 Byte.hashCode() 兼容。
int intValue() 在扩展原语转换后,将此 Byte 的值作为 int 返回。
long longValue() 在扩展原语转换后将此 Byte 的值作为 long 返回。
static byte parseByte(String s) 将字符串参数解析为有符号十进制字节。
static byte parseByte(String s, int radix) 将字符串参数解析为第二个参数指定的基数中的有符号字节。
short shortValue() 在扩展原语转换后,将此 Byte 的值作为短返回。
String toString() 返回表示此 Byte 值的 String 对象。
static String toString(byte b) 返回一个表示指定字节的新 String 对象。
static int toUnsignedInt(byte x) 通过无符号转换将参数转换为 int。
static long toUnsignedLong(byte x) 通过无符号转换将参数转换为 long。
static Byte valueOf(byte b) 返回表示指定字节值的 Byte 实例。
static Byte valueOf(String s) 返回一个 Byte 对象,该对象保存由指定 String 给出的值。
static Byte valueOf(String s, int radix) 当使用第二个参数给出的基数进行解析时,返回一个 Byte 对象,该对象包含从指定 String 中提取的值。
从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

BYTES

public static final int BYTES

用于以二进制补码形式表示字节值的字节数。

MAX_VALUE

public static final byte MAX_VALUE

一个保持字节可以具有的最大值的常量,27-1。

MIN_VALUE

public static final byte MIN_VALUE

一个保持字节可以具有的最小值的常量,-27。

SIZE

public static final int SIZE

用于以二进制补码形式表示字节值的位数。

TYPE

public static final ClassByte TYPE

表示原始类型字节的 Class 实例。

构造函数详细信息

Byte

public Byte(byte value)

构造一个新分配的 Byte 对象,该对象表示指定的字节值。

参数:

参数名称 参数描述
value 要由 Byte 表示的值。

Byte

public Byte(String s) throws NumberFormatException

构造一个新分配的 Byte 对象,该对象表示由 String 参数指示的字节值。 字符串转换为字节值的方式与 parseByte 方法用于基数 10 的方式完全相同。

参数:

参数名称 参数描述
s 要转换为字节的字符串

Throws:

Throw名称 Throw描述
NumberFormatException 如果字符串不包含可解析字节。

方法详情

toString

public static String toString(byte b)

返回一个表示指定字节的新 String 对象。 基数假定为 10。

参数:

参数名称 参数描述
b 要转换的字节

返回:

指定字节的字符串表示

valueOf

public static Byte valueOf(byte b)

返回表示指定字节值的 Byte 实例。 如果不需要新的 Byte 实例,则通常应优先使用此方法而不是构造函数 Byte(byte),因为此方法可能会产生明显更好的空间和时间性能,因为所有字节值都被缓存。

参数:

参数名称 参数描述
b 一个字节值。

返回:

代表 b 的 Byte 实例。

parseByte

public static byte parseByte(String s, int radix) throws NumberFormatException

将字符串参数解析为第二个参数指定的基数中的有符号字节。 字符串中的字符必须都是指定基数的数字(由 Character.digit(char, int) 是否返回非负值决定),但第一个字符可能是 ASCII 减号 ‘-‘ (‘\u002D ‘) 表示负值或 ASCII 加号 ‘+’ (‘\u002B’) 表示正值。 返回结果字节值。

如果发生以下任何一种情况,则会引发 NumberFormatException 类型的异常:

  • 第一个参数为空或长度为零的字符串。
  • 基数小于 Character.MIN_RADIX 或大于 Character.MAX_RADIX。
  • 字符串的任何字符都不是指定基数的数字,除非第一个字符可以是减号’-‘(’\u002D’)或加号’+’(’\u002B’),前提是字符串 比长度 1 长。
  • 字符串表示的值不是字节类型的值。

参数:

参数名称 参数描述
s 包含要解析的字节表示的字符串
radix 解析 s 时要使用的基数

返回:

由指定基数中的字符串参数表示的字节值

Throws:

Throw名称 Throw描述
NumberFormatException 如果字符串不包含可解析字节。

parseByte

public static byte parseByte(String s) throws NumberFormatException

将字符串参数解析为有符号十进制字节。 字符串中的字符必须都是十进制数字,除了第一个字符可以是ASCII减号’-‘(’\u002D’)表示负值或ASCII加号’+’(’\u002B’) 表示正值。 返回结果字节值,就像将参数和基数 10 作为参数提供给 parseByte(java.lang.String,int) 方法一样。

参数:

参数名称 参数描述
s 一个包含要解析的字节表示的字符串

返回:

十进制参数表示的字节值

Throws:

Throw名称 Throw描述
NumberFormatException 如果字符串不包含可解析字节。

valueOf

public static Byte valueOf(String s, int radix) throws NumberFormatException

当使用第二个参数给出的基数进行解析时,返回一个 Byte 对象,该对象包含从指定 String 中提取的值。 第一个参数被解释为表示由第二个参数指定的基数中的有符号字节,就像将该参数提供给 parseByte(java.lang.String,int) 方法一样。 结果是一个 Byte 对象,它表示字符串指定的字节值。

换句话说,此方法返回一个 Byte 对象,其值等于:

new Byte(Byte.parseByte(s, radix))

参数:

参数名称 参数描述
s 要解析的字符串
radix 用于解释 s 的基数

返回:

一个 Byte 对象,保存由指定基数中的字符串参数表示的值。

Throws:

Throw名称 Throw描述
NumberFormatException 如果字符串不包含可解析字节。

valueOf

public static Byte valueOf(String s) throws NumberFormatException

返回一个 Byte 对象,该对象保存由指定 String 给出的值。 该参数被解释为表示一个带符号的十进制字节,就像将该参数提供给 parseByte(java.lang.String) 方法一样。 结果是一个 Byte 对象,它表示字符串指定的字节值。

换句话说,此方法返回一个 Byte 对象,其值等于:

new Byte(Byte.parseByte(s))

参数:

参数名称 参数描述
s 要解析的字符串

返回:

一个 Byte 对象,保存由字符串参数表示的值

Throws:

Throw名称 Throw描述
NumberFormatException 如果字符串不包含可解析字节。

decode

public static Byte decode(String nm) throws NumberFormatException

将字符串解码为字节。 接受以下语法给出的十进制、十六进制和八进制数:

可解码字符串:

Signopt 十进制数字

Signopt 0x HexDigits

Signopt 0X HexDigits

Signopt #HexDigits

Signopt 0 八进制数字

符号:

+

DecimalNumeral、HexDigits 和 OctalDigits 的定义见《Java™ 语言规范》第 3.10.1 节,但数字之间不接受下划线。

跟随可选符号和/或基数说明符(“0x”、“0X”、“#”或前导零)的字符序列被 Byte.parseByte 方法解析为具有指示的基数(10、16 或 8 )。 此字符序列必须表示正值,否则将引发 NumberFormatException。 如果指定字符串的第一个字符是减号,则结果为否定。 字符串中不允许有空格字符。

参数:

参数名称 参数描述
nm 要解码的字符串。

返回:

保存由 nm 表示的字节值的 Byte 对象

Throws:

Throw名称 Throw描述
NumberFormatException 如果字符串不包含可解析字节。

byteValue

public byte byteValue()

以字节形式返回此 Byte 的值。

覆盖:

类 Number 中的 byteValue

返回:

此对象在转换为字节类型后表示的数值。

shortValue

public short shortValue()

在扩展原语转换后,将此 Byte 的值作为短返回。

覆盖:

类 Number 中的 shortValue

返回:

此对象在转换为 short 类型后表示的数值。

intValue

public int intValue()

在扩展原语转换后,将此 Byte 的值作为 int 返回。

指定者:

类 Number 中的 intValue

返回:

此对象在转换为 int 类型后表示的数值。

longValue

public long longValue()

在扩展原语转换后将此 Byte 的值作为 long 返回。

指定者:

类 Number 中的 longValue

返回:

此对象在转换为 long 类型后表示的数值。

floatValue

public float floatValue()

在扩大基元转换后,将此 Byte 的值作为浮点数返回。

指定者:

类 Number 中的 floatValue

返回:

此对象在转换为 float 类型后表示的数值。

doubleValue

public double doubleValue()

在扩大原始转换后,将此 Byte 的值作为双精度值返回。

指定者:

类 Number 中的 doubleValue

返回:

此对象在转换为 double 类型后表示的数值。

toString

public String toString()

返回表示此 Byte 值的 String 对象。 该值被转换为带符号的十进制表示并以字符串形式返回,就像将字节值作为参数提供给 toString(byte) 方法一样。

覆盖:

类 Object 中的 toString

返回:

以 10 为基数的此对象值的字符串表示形式。

hashCode

public int hashCode()

返回此字节的哈希码; 等于调用 intValue() 的结果。

覆盖:

类 Object 中的 hashCode

返回:

此字节的哈希码值

hashCode

public static int hashCode(byte value)

返回字节值的哈希码; 与 Byte.hashCode() 兼容。

参数:

参数名称 参数描述
value 要散列的值

返回:

字节值的哈希码值。

equals

public boolean equals(Object obj)

将此对象与指定对象进行比较。 当且仅当参数不为 null 并且是包含与此对象相同的字节值的 Byte 对象时,结果才为真。

覆盖:

类 Object 中的等于

参数:

参数名称 参数描述
obj 比较的对象

返回:

如果对象相同,则为 true; 否则为假。

compareTo

public int compareTo(Byte anotherByte)

以数字方式比较两个 Byte 对象。

指定者:

接口 ComparableByte 中的 compareTo

参数:

参数名称 参数描述
anotherByte 要比较的字节。

返回:

如果此 Byte 等于参数 Byte,则值为 0; 如果此 Byte 在数值上小于参数 Byte,则值小于 0; 如果此 Byte 在数值上大于参数 Byte(有符号比较),则值大于 0。

compare

public static int compare(byte x, byte y)

以数字方式比较两个字节值。 返回的值与通过以下方式返回的值相同:

    Byte.valueOf(x).compareTo(Byte.valueOf(y)) 

参数:

参数名称 参数描述
x 要比较的第一个字节
y 要比较的第二个字节

返回:

如果 x == y,则值为 0; 如果 x < y,则值小于 0; 如果 x > y,则值大于 0

toUnsignedInt

public static int toUnsignedInt(byte x)

通过无符号转换将参数转换为 int。 在到 int 的无符号转换中,int 的高 24 位为零,低 8 位等于 byte 参数的位。 因此,零和正字节值映射到数值相等的 int 值,负字节值映射到等于输入加 28 的 int 值。

参数:

参数名称 参数描述
x 要转换为无符号整数的值

返回:

通过无符号转换转换为 int 的参数

toUnsignedLong

public static long toUnsignedLong(byte x)

通过无符号转换将参数转换为 long。 在到 long 的无符号转换中,long 的高 56 位为零,低 8 位等于 byte 参数的位。 因此,零和正字节值映射到数值相等的长整数值,负字节值映射到等于输入加 28 的长整数值。

参数:

参数名称 参数描述
x 要转换为无符号长整数的值

返回:

通过无符号转换转换为 long 的参数

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS Byte》
文章链接:https://zhuji.vsping.com/313299.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。