鴻蒙OS Byte

Byte

java.lang.Object

|---java.lang.Number

|---|---java.lang.Byte

public final class Byte
extends Number
implements Comparable<Byte>

Byte 類(lèi)將原始類(lèi)型 byte 的值包裝在一個(gè)對(duì)象中。 Byte 類(lèi)型的對(duì)象包含一個(gè)類(lèi)型為 byte 的字段。

此外，該類(lèi)提供了幾種將字節(jié)轉(zhuǎn)換為字符串和將字符串轉(zhuǎn)換為字節(jié)的方法，以及在處理字節(jié)時(shí)有用的其他常量和方法。

字段摘要

修飾符和類(lèi)型	字段	描述
static int	BYTES	用于以二進(jìn)制補(bǔ)碼形式表示字節(jié)值的字節(jié)數(shù)。
static byte	MAX_VALUE	一個(gè)保持字節(jié)可以具有的最大值的常量，27-1。
static byte	MIN_VALUE	一個(gè)保持字節(jié)可以具有的最小值的常量，-27。
static int	SIZE	用于以二進(jìn)制補(bǔ)碼形式表示字節(jié)值的位數(shù)。
static ClassByte	TYPE	表示原始類(lèi)型字節(jié)的 Class 實(shí)例。

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
Byte(byte value)	構(gòu)造一個(gè)新分配的 Byte 對(duì)象，該對(duì)象表示指定的字節(jié)值。
Byte(String s)	構(gòu)造一個(gè)新分配的 Byte 對(duì)象，該對(duì)象表示由 String 參數(shù)指示的字節(jié)值。

方法總結(jié)

修飾符和類(lèi)型	方法	描述
byte	byteValue()	以字節(jié)形式返回此 Byte 的值。
static int	compare(byte x, byte y)	以數(shù)字方式比較兩個(gè)字節(jié)值。
int	compareTo(Byte anotherByte)	以數(shù)字方式比較兩個(gè) Byte 對(duì)象。
static Byte	decode(String nm)	將字符串解碼為字節(jié)。
double	doubleValue()	在擴(kuò)大原始轉(zhuǎn)換后，將此 Byte 的值作為雙精度值返回。
boolean	equals(Object obj)	將此對(duì)象與指定對(duì)象進(jìn)行比較。
float	floatValue()	在擴(kuò)大基元轉(zhuǎn)換后，將此 Byte 的值作為浮點(diǎn)數(shù)返回。
int	hashCode()	返回此字節(jié)的哈希碼； 等于調(diào)用 intValue() 的結(jié)果。
static int	hashCode(byte value)	返回字節(jié)值的哈希碼； 與 Byte.hashCode() 兼容。
int	intValue()	在擴(kuò)展原語(yǔ)轉(zhuǎn)換后，將此 Byte 的值作為 int 返回。
long	longValue()	在擴(kuò)展原語(yǔ)轉(zhuǎn)換后將此 Byte 的值作為 long 返回。
static byte	parseByte(String s)	將字符串參數(shù)解析為有符號(hào)十進(jìn)制字節(jié)。
static byte	parseByte(String s, int radix)	將字符串參數(shù)解析為第二個(gè)參數(shù)指定的基數(shù)中的有符號(hào)字節(jié)。
short	shortValue()	在擴(kuò)展原語(yǔ)轉(zhuǎn)換后，將此 Byte 的值作為短返回。
String	toString()	返回表示此 Byte 值的 String 對(duì)象。
static String	toString(byte b)	返回一個(gè)表示指定字節(jié)的新 String 對(duì)象。
static int	toUnsignedInt(byte x)	通過(guò)無(wú)符號(hào)轉(zhuǎn)換將參數(shù)轉(zhuǎn)換為 int。
static long	toUnsignedLong(byte x)	通過(guò)無(wú)符號(hào)轉(zhuǎn)換將參數(shù)轉(zhuǎn)換為 long。
static Byte	valueOf(byte b)	返回表示指定字節(jié)值的 Byte 實(shí)例。
static Byte	valueOf(String s)	返回一個(gè) Byte 對(duì)象，該對(duì)象保存由指定 String 給出的值。
static Byte	valueOf(String s, int radix)	當(dāng)使用第二個(gè)參數(shù)給出的基數(shù)進(jìn)行解析時(shí)，返回一個(gè) Byte 對(duì)象，該對(duì)象包含從指定 String 中提取的值。

從類(lèi) java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段詳細(xì)信息

BYTES

public static final int BYTES

用于以二進(jìn)制補(bǔ)碼形式表示字節(jié)值的字節(jié)數(shù)。

MAX_VALUE

public static final byte MAX_VALUE

一個(gè)保持字節(jié)可以具有的最大值的常量，27-1。

MIN_VALUE

public static final byte MIN_VALUE

一個(gè)保持字節(jié)可以具有的最小值的常量，-27。

SIZE

public static final int SIZE

用于以二進(jìn)制補(bǔ)碼形式表示字節(jié)值的位數(shù)。

TYPE

public static final ClassByte TYPE

表示原始類(lèi)型字節(jié)的 Class 實(shí)例。

構(gòu)造函數(shù)詳細(xì)信息

Byte

public Byte(byte value)

構(gòu)造一個(gè)新分配的 Byte 對(duì)象，該對(duì)象表示指定的字節(jié)值。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
value	要由 Byte 表示的值。

Byte

public Byte(String s) throws NumberFormatException

構(gòu)造一個(gè)新分配的 Byte 對(duì)象，該對(duì)象表示由 String 參數(shù)指示的字節(jié)值。 字符串轉(zhuǎn)換為字節(jié)值的方式與 parseByte 方法用于基數(shù) 10 的方式完全相同。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
s	要轉(zhuǎn)換為字節(jié)的字符串

Throws:

Throw名稱(chēng)	Throw描述
NumberFormatException	如果字符串不包含可解析字節(jié)。

方法詳情

toString

public static String toString(byte b)

返回一個(gè)表示指定字節(jié)的新 String 對(duì)象。 基數(shù)假定為 10。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
b	要轉(zhuǎn)換的字節(jié)

返回:

指定字節(jié)的字符串表示

valueOf

public static Byte valueOf(byte b)

返回表示指定字節(jié)值的 Byte 實(shí)例。 如果不需要新的 Byte 實(shí)例，則通常應(yīng)優(yōu)先使用此方法而不是構(gòu)造函數(shù) Byte(byte)，因?yàn)榇朔椒赡軙?huì)產(chǎn)生明顯更好的空間和時(shí)間性能，因?yàn)樗凶止?jié)值都被緩存。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
b	一個(gè)字節(jié)值。

返回:

代表 b 的 Byte 實(shí)例。

parseByte

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

將字符串參數(shù)解析為第二個(gè)參數(shù)指定的基數(shù)中的有符號(hào)字節(jié)。 字符串中的字符必須都是指定基數(shù)的數(shù)字（由 Character.digit(char, int) 是否返回非負(fù)值決定），但第一個(gè)字符可能是 ASCII 減號(hào) '-' ('\u002D ') 表示負(fù)值或 ASCII 加號(hào) '+' ('\u002B') 表示正值。 返回結(jié)果字節(jié)值。

如果發(fā)生以下任何一種情況，則會(huì)引發(fā) NumberFormatException 類(lèi)型的異常：

• 第一個(gè)參數(shù)為空或長(zhǎng)度為零的字符串。
• 基數(shù)小于 Character.MIN_RADIX 或大于 Character.MAX_RADIX。
• 字符串的任何字符都不是指定基數(shù)的數(shù)字，除非第一個(gè)字符可以是減號(hào)'-'（'\u002D'）或加號(hào)'+'（'\u002B'），前提是字符串 比長(zhǎng)度 1 長(zhǎng)。
• 字符串表示的值不是字節(jié)類(lèi)型的值。

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
s	包含要解析的字節(jié)表示的字符串
radix	解析 s 時(shí)要使用的基數(shù)

返回:

由指定基數(shù)中的字符串參數(shù)表示的字節(jié)值

Throws:

Throw名稱(chēng)	Throw描述
NumberFormatException	如果字符串不包含可解析字節(jié)。

parseByte

public static byte parseByte(String s) throws NumberFormatException

將字符串參數(shù)解析為有符號(hào)十進(jìn)制字節(jié)。 字符串中的字符必須都是十進(jìn)制數(shù)字，除了第一個(gè)字符可以是ASCII減號(hào)'-'（'\u002D'）表示負(fù)值或ASCII加號(hào)'+'（'\u002B'） 表示正值。 返回結(jié)果字節(jié)值，就像將參數(shù)和基數(shù) 10 作為參數(shù)提供給 parseByte(java.lang.String,int) 方法一樣。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
s	一個(gè)包含要解析的字節(jié)表示的字符串

返回:

十進(jìn)制參數(shù)表示的字節(jié)值

Throws:

Throw名稱(chēng)	Throw描述
NumberFormatException	如果字符串不包含可解析字節(jié)。

valueOf

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

當(dāng)使用第二個(gè)參數(shù)給出的基數(shù)進(jìn)行解析時(shí)，返回一個(gè) Byte 對(duì)象，該對(duì)象包含從指定 String 中提取的值。 第一個(gè)參數(shù)被解釋為表示由第二個(gè)參數(shù)指定的基數(shù)中的有符號(hào)字節(jié)，就像將該參數(shù)提供給 parseByte(java.lang.String,int) 方法一樣。 結(jié)果是一個(gè) Byte 對(duì)象，它表示字符串指定的字節(jié)值。

換句話說(shuō)，此方法返回一個(gè) Byte 對(duì)象，其值等于：

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

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
s	要解析的字符串
radix	用于解釋 s 的基數(shù)

返回:

一個(gè) Byte 對(duì)象，保存由指定基數(shù)中的字符串參數(shù)表示的值。

Throws:

Throw名稱(chēng)	Throw描述
NumberFormatException	如果字符串不包含可解析字節(jié)。

valueOf

public static Byte valueOf(String s) throws NumberFormatException

返回一個(gè) Byte 對(duì)象，該對(duì)象保存由指定 String 給出的值。 該參數(shù)被解釋為表示一個(gè)帶符號(hào)的十進(jìn)制字節(jié)，就像將該參數(shù)提供給 parseByte(java.lang.String) 方法一樣。 結(jié)果是一個(gè) Byte 對(duì)象，它表示字符串指定的字節(jié)值。

換句話說(shuō)，此方法返回一個(gè) Byte 對(duì)象，其值等于：

new Byte(Byte.parseByte(s))

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
s	要解析的字符串

返回:

一個(gè) Byte 對(duì)象，保存由字符串參數(shù)表示的值

Throws:

Throw名稱(chēng)	Throw描述
NumberFormatException	如果字符串不包含可解析字節(jié)。

decode

public static Byte decode(String nm) throws NumberFormatException

將字符串解碼為字節(jié)。 接受以下語(yǔ)法給出的十進(jìn)制、十六進(jìn)制和八進(jìn)制數(shù)：

可解碼字符串：

Signopt 十進(jìn)制數(shù)字

Signopt 0x HexDigits

Signopt 0X HexDigits

Signopt #HexDigits

Signopt 0 八進(jìn)制數(shù)字

符號(hào)：

+

DecimalNumeral、HexDigits 和 OctalDigits 的定義見(jiàn)《Java? 語(yǔ)言規(guī)范》第 3.10.1 節(jié)，但數(shù)字之間不接受下劃線。

跟隨可選符號(hào)和/或基數(shù)說(shuō)明符（“0x”、“0X”、“#”或前導(dǎo)零）的字符序列被 Byte.parseByte 方法解析為具有指示的基數(shù)（10、16 或 8 ）。 此字符序列必須表示正值，否則將引發(fā) NumberFormatException。 如果指定字符串的第一個(gè)字符是減號(hào)，則結(jié)果為否定。 字符串中不允許有空格字符。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
nm	要解碼的字符串。

返回:

保存由 nm 表示的字節(jié)值的 Byte 對(duì)象

Throws:

Throw名稱(chēng)	Throw描述
NumberFormatException	如果字符串不包含可解析字節(jié)。

byteValue

public byte byteValue()

以字節(jié)形式返回此 Byte 的值。

覆蓋：

類(lèi) Number 中的 byteValue

返回:

此對(duì)象在轉(zhuǎn)換為字節(jié)類(lèi)型后表示的數(shù)值。

shortValue

public short shortValue()

在擴(kuò)展原語(yǔ)轉(zhuǎn)換后，將此 Byte 的值作為短返回。

覆蓋：

類(lèi) Number 中的 shortValue

返回:

此對(duì)象在轉(zhuǎn)換為 short 類(lèi)型后表示的數(shù)值。

intValue

public int intValue()

在擴(kuò)展原語(yǔ)轉(zhuǎn)換后，將此 Byte 的值作為 int 返回。

指定者：

類(lèi) Number 中的 intValue

返回:

此對(duì)象在轉(zhuǎn)換為 int 類(lèi)型后表示的數(shù)值。

longValue

public long longValue()

在擴(kuò)展原語(yǔ)轉(zhuǎn)換后將此 Byte 的值作為 long 返回。

指定者：

類(lèi) Number 中的 longValue

返回:

此對(duì)象在轉(zhuǎn)換為 long 類(lèi)型后表示的數(shù)值。

floatValue

public float floatValue()

在擴(kuò)大基元轉(zhuǎn)換后，將此 Byte 的值作為浮點(diǎn)數(shù)返回。

指定者：

類(lèi) Number 中的 floatValue

返回:

此對(duì)象在轉(zhuǎn)換為 float 類(lèi)型后表示的數(shù)值。

doubleValue

public double doubleValue()

在擴(kuò)大原始轉(zhuǎn)換后，將此 Byte 的值作為雙精度值返回。

指定者：

類(lèi) Number 中的 doubleValue

返回:

此對(duì)象在轉(zhuǎn)換為 double 類(lèi)型后表示的數(shù)值。

toString

public String toString()

返回表示此 Byte 值的 String 對(duì)象。 該值被轉(zhuǎn)換為帶符號(hào)的十進(jìn)制表示并以字符串形式返回，就像將字節(jié)值作為參數(shù)提供給 toString(byte) 方法一樣。

覆蓋：

類(lèi) Object 中的 toString

返回:

以 10 為基數(shù)的此對(duì)象值的字符串表示形式。

hashCode

public int hashCode()

返回此字節(jié)的哈希碼； 等于調(diào)用 intValue() 的結(jié)果。

覆蓋：

類(lèi) Object 中的 hashCode

返回:

此字節(jié)的哈希碼值

hashCode

public static int hashCode(byte value)

返回字節(jié)值的哈希碼； 與 Byte.hashCode() 兼容。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
value	要散列的值

返回:

字節(jié)值的哈希碼值。

equals

public boolean equals(Object obj)

將此對(duì)象與指定對(duì)象進(jìn)行比較。 當(dāng)且僅當(dāng)參數(shù)不為 null 并且是包含與此對(duì)象相同的字節(jié)值的 Byte 對(duì)象時(shí)，結(jié)果才為真。

覆蓋：

類(lèi) Object 中的等于

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
obj	比較的對(duì)象

返回:

如果對(duì)象相同，則為 true； 否則為假。

compareTo

public int compareTo(Byte anotherByte)

以數(shù)字方式比較兩個(gè) Byte 對(duì)象。

指定者：

接口 ComparableByte 中的 compareTo

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
anotherByte	要比較的字節(jié)。

返回:

如果此 Byte 等于參數(shù) Byte，則值為 0； 如果此 Byte 在數(shù)值上小于參數(shù) Byte，則值小于 0； 如果此 Byte 在數(shù)值上大于參數(shù) Byte（有符號(hào)比較），則值大于 0。

compare

public static int compare(byte x, byte y)

以數(shù)字方式比較兩個(gè)字節(jié)值。 返回的值與通過(guò)以下方式返回的值相同：

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

參數(shù):

參數(shù)名稱(chēng)	參數(shù)描述
x	要比較的第一個(gè)字節(jié)
y	要比較的第二個(gè)字節(jié)

返回:

如果 x == y，則值為 0； 如果 x < y，則值小于 0； 如果 x > y，則值大于 0

toUnsignedInt

public static int toUnsignedInt(byte x)

通過(guò)無(wú)符號(hào)轉(zhuǎn)換將參數(shù)轉(zhuǎn)換為 int。 在到 int 的無(wú)符號(hào)轉(zhuǎn)換中，int 的高 24 位為零，低 8 位等于 byte 參數(shù)的位。 因此，零和正字節(jié)值映射到數(shù)值相等的 int 值，負(fù)字節(jié)值映射到等于輸入加 28 的 int 值。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
x	要轉(zhuǎn)換為無(wú)符號(hào)整數(shù)的值

返回:

通過(guò)無(wú)符號(hào)轉(zhuǎn)換轉(zhuǎn)換為 int 的參數(shù)

toUnsignedLong

public static long toUnsignedLong(byte x)

通過(guò)無(wú)符號(hào)轉(zhuǎn)換將參數(shù)轉(zhuǎn)換為 long。 在到 long 的無(wú)符號(hào)轉(zhuǎn)換中，long 的高 56 位為零，低 8 位等于 byte 參數(shù)的位。 因此，零和正字節(jié)值映射到數(shù)值相等的長(zhǎng)整數(shù)值，負(fù)字節(jié)值映射到等于輸入加 28 的長(zhǎng)整數(shù)值。

參數(shù)：

參數(shù)名稱(chēng)	參數(shù)描述
x	要轉(zhuǎn)換為無(wú)符號(hào)長(zhǎng)整數(shù)的值

返回:

通過(guò)無(wú)符號(hào)轉(zhuǎn)換轉(zhuǎn)換為 long 的參數(shù)