模块 java.base

包 java.lang

类 Short

java.lang.Object

java.lang.Number

java.lang.Short

所有已实现的接口：

Serializable , Comparable<Short> , Constable

public final class Short extends Number implements Comparable <Short >, Constable 
      

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

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

这是一个value-based类；程序员应该将 equal 的实例视为可互换的，并且不应使用实例进行同步，否则可能会发生不可预测的行为。例如，在未来的版本中，同步可能会失败。

自从：

1.1

参见：

• Number
• Serialized Form

字段摘要

字段

修饰符和类型	Field	描述
static final int	BYTES	用于表示二进制补码形式的 short 值的字节数。
static final short	MAX_VALUE	一个保持最大值的常量 short 可以有，215-1.
static final short	MIN_VALUE	一个保持最小值的常量 a short 可以有，-215.
static final int	SIZE	用于以二进制补码形式表示 short 值的位数。
static final Class<Short>	TYPE	代表原始类型 short 的 Class 实例。

构造方法总结

构造方法

构造方法	描述
Short(short value)	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 使用此构造方法很少是合适的。
Short(String s)	已弃用，将被删除：此 API 元素可能会在未来版本中删除。 使用此构造方法很少是合适的。

方法总结

修饰符和类型	方法	描述
byte	byteValue()	在缩小基元转换后将此 Short 的值作为 byte 返回。
static int	compare(short x, short y)	以数字方式比较两个 short 值。
int	compareTo(Short anotherShort)	在数值上比较两个 Short 对象。
static int	compareUnsigned(short x, short y)	比较两个 short 值，在数值上将值视为无符号。
static Short	decode(String nm)	将 String 解码为 Short 。
Optional<DynamicConstantDesc<Short>>	describeConstable()	返回包含此实例标称描述符的 Optional 。
double	doubleValue()	在扩大基元转换后将此 Short 的值作为 double 返回。
boolean	equals(Object obj)	将此对象与指定对象进行比较。
float	floatValue()	在扩大原始转换后将此 Short 的值作为 float 返回。
int	hashCode()	返回此 Short 的哈希码；等于调用 intValue() 的结果。
static int	hashCode(short value)	返回 short 值的哈希码；与 Short.hashCode() 兼容。
int	intValue()	在扩大基元转换后将此 Short 的值作为 int 返回。
long	longValue()	在扩大原始转换后将此 Short 的值作为 long 返回。
static short	parseShort(String s)	将字符串参数解析为带符号的十进制 short 。
static short	parseShort(String s, int radix)	将字符串参数解析为第二个参数指定的基数中带符号的 short。
static short	reverseBytes(short i)	返回通过反转指定 short 值的二进制补码表示中的字节顺序获得的值。
short	shortValue()	将此 Short 的值作为 short 返回。
String	toString()	返回表示此 Short 值的 String 对象。
static String	toString(short s)	返回表示指定 short 的新 String 对象。
static int	toUnsignedInt(short x)	通过无符号转换将参数转换为 int。
static long	toUnsignedLong(short x)	通过无符号转换将参数转换为 long。
static Short	valueOf(short s)	返回代表指定 short 值的 Short 实例。
static Short	valueOf(String s)	返回一个 Short 对象，其中包含由指定的 String 给出的值。
static Short	valueOf(String s, int radix)	返回一个 Short 对象，其中包含在使用第二个参数给出的基数进行解析时从指定的 String 中提取的值。

在类 java.lang.Object 中声明的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

字段详细信息

MIN_VALUE

public static final short MIN_VALUE
            

一个保持最小值的常量 a short 可以有，-2¹⁵.

参见：

• 常量字段值

MAX_VALUE

public static final short MAX_VALUE
            

一个保持最大值的常量 short 可以有，2¹⁵-1.

参见：

• 常量字段值

TYPE

public static final Class <Short > TYPE
            

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

SIZE

public static final int SIZE
            

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

自从：

1.5

参见：

• 常量字段值

BYTES

public static final int BYTES
            

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

自从：

1.8

参见：

• 常量字段值

构造方法详细信息

Short

@Deprecated (since ="9", forRemoval =true) public Short(short value)
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

使用此构造函数很少是合适的。静态工厂 valueOf(short) 通常是更好的选择，因为它可能会产生明显更好的空间和时间性能。

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

参数：

value - Short 表示的值。

Short

@Deprecated (since ="9", forRemoval =true) public Short(String  s) throws NumberFormatException 
            

已弃用，将被删除：此 API 元素可能会在未来版本中删除。

使用此构造函数很少是合适的。使用 parseShort(String) 将字符串转换为 short 基元，或使用 valueOf(String) 将字符串转换为 Short 对象。

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

参数：

s - 要转换为 Short 的 String

抛出：

NumberFormatException - 如果 String 不包含可解析的 short。

方法详情

toString

public static String  toString(short s)
            

返回表示指定 short 的新 String 对象。假定基数为 10。

参数：

s - 要转换的 short

返回：

指定 short 的字符串表示形式

参见：

• Integer.toString(int)

parseShort

public static short parseShort(String  s, int radix) throws NumberFormatException 
            

将字符串参数解析为第二个参数指定的基数中带符号的 short。字符串中的字符必须都是指定基数的数字（由 Character.digit(char, int) 是否返回非负值决定），除了第一个字符可以是 ASCII 减号 '-' ('\u002D' ) 以指示负值或 ASCII 加号'+' ('\u002B') 表示正值。返回结果 short 值。

如果出现以下任何一种情况，将抛出NumberFormatException类型的异常：

• 第一个参数是 null 或者是一个长度为零的字符串。
• 基数小于 Character.MIN_RADIX 或大于 Character.MAX_RADIX 。
• 字符串的任何字符都不是指定基数的数字，但第一个字符可以是减号 '-' ('\u002D' ) 或加号 '+' ('\u002B' )，前提是字符串的长度大于长度 1。
• 字符串表示的值不是 short 类型的值。

参数：

s - 包含要解析的 short 表示的 String

radix - 解析 s 时使用的基数

返回：

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

抛出：

NumberFormatException - 如果 String 不包含可解析的 short。

parseShort

public static short parseShort(String  s) throws NumberFormatException 
            

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

参数：

s - 一个 String 包含要解析的 short 表示

返回：

short 值由十进制参数表示。

抛出：

NumberFormatException - 如果字符串不包含可解析的 short。

valueOf

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

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

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

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

参数：

s - 要解析的字符串

radix - 用于解释 s 的基数

返回：

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

抛出：

NumberFormatException - 如果 String 不包含可解析的 short。

valueOf

public static Short  valueOf(String  s) throws NumberFormatException 
            

返回一个 Short 对象，其中包含由指定的 String 给出的值。该参数被解释为表示带符号的十进制 short ，就好像该参数被提供给 parseShort(java.lang.String) 方法一样。结果是一个 Short 对象，表示由字符串指定的 short 值。

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

Short.valueOf(Short.parseShort(s))

参数：

s - 要解析的字符串

返回：

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

抛出：

NumberFormatException - 如果 String 不包含可解析的 short。

describeConstable

public Optional <DynamicConstantDesc <Short >> describeConstable()
            

返回包含此实例标称描述符的 Optional 。

指定者：

describeConstable 在接口 Constable 中

返回：

Optional 描述了 Short 实例

自从：

15

valueOf

public static Short  valueOf(short s)
            

返回代表指定 short 值的 Short 实例。如果不需要新的 Short 实例，通常应优先使用此方法而不是构造函数 Short(short) ，因为此方法可能会通过缓存频繁请求的值来产生明显更好的空间和时间性能。此方法将始终缓存 -128 到 127（含）范围内的值，并可能缓存此范围之外的其他值。

参数：

s - 短值。

返回：

代表 s 的 Short 实例。

自从：

1.5

decode

public static Short  decode(String  nm) throws NumberFormatException 
            

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

可解码字符串：

符号_选择 DecimalNumeral

符号_选择 0x HexDigits

符号_选择 0X HexDigits

符号_选择 # HexDigits

符号_选择 0 OctalDigits

符号：

-

+

DecimalNumeral, HexDigits， 和OctalDigits如第 3.10.1 节中所定义Java 语言规范, 除了数字之间不接受下划线。

可选符号和/或基数说明符（“0x”、“0X”、“#”或前导零）后面的字符序列由具有指定基数（10、16 或 8）的 Short.parseShort 方法解析。此字符序列必须表示正值，否则将抛出 NumberFormatException 。如果指定的 String 的第一个字符是减号，则结果取反。 String 中不允许有空白字符。

参数：

nm - 要解码的 String。

返回：

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

抛出：

NumberFormatException - 如果 String 不包含可解析的 short 。

参见：

• parseShort(java.lang.String, int)

byteValue

public byte byteValue()
            

在缩小基元转换后将此 Short 的值作为 byte 返回。

重写：

byteValue 在类 Number 中

返回：

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

看Java 语言规范:

5.1.3 缩小原始转换

shortValue

public short shortValue()
            

将此 Short 的值作为 short 返回。

重写：

shortValue 在类 Number 中

返回：

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

intValue

public int intValue()
            

在扩大基元转换后将此 Short 的值作为 int 返回。

指定者：

intValue 在类 Number 中

返回：

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

看Java 语言规范:

5.1.2 拓宽原始转换

longValue

public long longValue()
            

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

指定者：

longValue 在类 Number 中

返回：

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

看Java 语言规范:

5.1.2 拓宽原始转换

floatValue

public float floatValue()
            

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

指定者：

floatValue 在类 Number 中

返回：

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

看Java 语言规范:

5.1.2 拓宽原始转换

doubleValue

public double doubleValue()
            

在扩大基元转换后将此 Short 的值作为 double 返回。

指定者：

doubleValue 在类 Number 中

返回：

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

看Java 语言规范:

5.1.2 拓宽原始转换

toString

public String  toString()
            

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

重写：

toString 在类 Object 中

返回：

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

hashCode

public int hashCode()
            

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

重写：

hashCode 在类 Object 中

返回：

这个 Short 的哈希码值

参见：

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

hashCode

public static int hashCode(short value)
            

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

参数：

value - 要散列的值

返回：

short 值的哈希码值。

自从：

1.8

equals

public boolean equals(Object  obj)
            

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

重写：

equals 在类 Object 中

参数：

obj - 要与之比较的对象

返回：

true 如果对象相同； false否则。

参见：

• Object.hashCode()
• HashMap

compareTo

public int compareTo(Short  anotherShort)
            

在数值上比较两个 Short 对象。

指定者：

compareTo 在接口 Comparable<Short> 中

参数：

anotherShort - 要比较的 Short。

返回：

值 0 如果这个 Short 等于参数 Short ；一个小于 0 的值，如果这个 Short 在数值上小于参数 Short ；和大于 0 的值，如果此 Short 在数值上大于参数 Short（有符号比较）。

自从：

1.2

compare

public static int compare(short x, short y)
            

以数字方式比较两个 short 值。返回的值与将返回的值相同：

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

参数：

x - 第一个要比较的 short

y - 要比较的第二个 short

返回：

值 0 如果 x == y ；如果 x < y 小于 0 的值；如果 x > y，则值大于 0

自从：

1.7

compareUnsigned

public static int compareUnsigned(short x, short y)
            

比较两个 short 值，在数值上将值视为无符号。

参数：

x - 第一个要比较的 short

y - 要比较的第二个 short

返回：

值 0 如果 x == y ；如果 x < y 为无符号值，则小于 0 的值；如果 x > y 为无符号值，则值大于 0

自从：

9

reverseBytes

public static short reverseBytes(short i)
            

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

参数：

i - 要反转其字节的值

返回：

通过反转（或等效地交换）指定 short 值中的字节获得的值。

自从：

1.5

toUnsignedInt

public static int toUnsignedInt(short x)
            

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

参数：

x - 要转换为无符号 int 的值

返回：

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

自从：

1.8

toUnsignedLong

public static long toUnsignedLong(short x)
            

通过无符号转换将参数转换为 long。在到 long 的无符号转换中，long 的高 48 位为零，低 16 位等于 short 参数的位。因此，零和正 short 值映射到数值上相等的 long 值，负 short 值映射到等于输入加 2 的 long 值¹⁶.

参数：

x - 要转换为无符号 long 的值

返回：

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

自从：

1.8