阅读(3323) (0)

鸿蒙OS Short

2022-04-28 16:00:18 更新

Short

java.lang.Object

|---java.lang.Number

|---|---java.lang.Short

public final class Short
extends Number
implements Comparable<Short>

Short 类将原始类型 short 的值包装在对象中。 Short 类型的对象包含一个 short 类型的字段。

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

字段摘要

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

构造函数摘要

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

方法总结

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

字段详细信息

BYTES

public static final int BYTES

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

MAX_VALUE

public static final short MAX_VALUE

一个保持空头可以拥有的最大值的常数,215-1。

MIN_VALUE

public static final short MIN_VALUE

一个保持空头可以拥有的最小值的常数,-215。

SIZE

public static final int SIZE

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

TYPE

public static final ClassShort TYPE

表示原始类型 short 的 Class 实例。

构造函数详细信息

Short

public Short(short value)

构造一个新分配的 Short 对象,该对象表示指定的 short 值。

参数:

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

Short

public Short(String s) throws NumberFormatException

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

参数:

参数名称 参数描述
s 要转换为 Short 的 String

Throws:

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

方法详情

toString

public static String toString(short s)

返回一个表示指定短的新字符串对象。 基数假定为 10。

参数:

参数名称 参数描述
s 要转换的short

返回:

指定短的字符串表示

parseShort

public static short parseShort(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 时要使用的基数

返回:

由指定基数中的字符串参数表示的short。

Throws:

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

parseShort

public static short parseShort(String s) throws NumberFormatException

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

参数:

参数名称 参数描述
s 一个包含要解析的short表示的string

返回:

由十进制参数表示的short值。

Throws:

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

valueOf

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

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

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

new Short(Short.parseShort(s, radix))

参数:

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

返回:

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

Throws:

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

valueOf

public static Short valueOf(String s) throws NumberFormatException

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

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

new Short(Short.parseShort(s))

参数:

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

返回:

保存字符串参数表示的值的 Short 对象

Throws:

Throw名称 Throw描述
NumberFormatException 如果 String 不包含可解析的 short。

valueOf

public static Short valueOf(short s)

返回一个表示指定短值的 Short 实例。 如果不需要新的 Short 实例,则通常应优先使用此方法而不是构造函数 Short(short),因为此方法可能会通过缓存频繁请求的值来显着提高空间和时间性能。 此方法将始终缓存 -128 到 127(含)范围内的值,并且可能缓存此范围之外的其他值。

参数:

参数名称 参数描述
s a short value.

返回:

表示 s 的 Short 实例。

decode

public static Short decode(String nm) throws NumberFormatException

将 String 解码为 Short。 接受以下语法给出的十进制、十六进制和八进制数:

可解码字符串:

Signopt 十进制数字

Signopt 0x HexDigits

Signopt 0X HexDigits

Signopt #HexDigits

Signopt 0 八进制数字

符号:

+

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

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

参数:

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

返回:

一个 Short 对象,持有由 nm 表示的 short 值

Throws:

Throw名称 Throw描述
NumberFormatException 如果 String 不包含可解析的 short。

byteValue

public byte byteValue()

在缩小原语转换后,将此 Short 的值作为字节返回。

覆盖:

类 Number 中的 byteValue

返回:

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

shortValue

public short shortValue()

将此 Short 的值作为 short 返回。

覆盖:

类 Number 中的 shortValue

返回:

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

intValue

public int intValue()

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

指定者:

类 Number 中的 intValue

返回:

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

longValue

public long longValue()

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

指定者:

类 Number 中的 longValue

返回:

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

floatValue

public float floatValue()

在扩大原始转换后,将此 Short 的值作为浮点数返回。

指定者:

类 Number 中的 floatValue

返回:

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

doubleValue

public double doubleValue()

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

指定者:

类 Number 中的 doubleValue

返回:

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

toString

public String toString()

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

覆盖:

类 Object 中的 toString

返回:

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

hashCode

public int hashCode()

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

覆盖:

类 Object 中的 hashCode

返回:

此 Short 的哈希码值

hashCode

public static int hashCode(short value)

返回short值的哈希码; 与 Short.hashCode() 兼容。

参数:

参数名称 参数描述
value 哈希值

返回:

short值的哈希码值。

equals

public boolean equals(Object obj)

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

覆盖:

类 Object 中的等于

参数:

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

返回:

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

compareTo

public int compareTo(Short anotherShort)

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

指定者:

接口 ComparableShort 中的 compareTo

参数:

参数名称 参数描述
anotherShort the Short to be compared.

返回:

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

compare

public static int compare(short x, short y)

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

    Short.valueOf(x).compareTo(Short.valueOf(y)) 

参数:

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

返回:

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

reverseBytes

public static short reverseBytes(short i)

返回通过反转指定短值的二进制补码表示中的字节顺序获得的值。

参数:

参数名称 参数描述
i 要反转其字节的值

返回:

通过反转(或等效地,交换)指定短值中的字节获得的值。

toUnsignedInt

public static int toUnsignedInt(short x)

通过无符号转换将参数转换为 int。 在到 int 的无符号转换中,int 的高 16 位为零,低 16 位等于 short 参数的位。 因此,零和正短值映射到数值相等的 int 值,负短值映射到等于输入加 216 的 int 值。

参数:

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

返回:

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

toUnsignedLong

public static long toUnsignedLong(short x)

通过无符号转换将参数转换为 long。 在到 long 的无符号转换中,long 的高 48 位为零,低 16 位等于 short 参数的位。 因此,零和正短值映射到数值相等的长值,负短值映射到等于输入加 216 的长值。

参数:

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

返回:

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