java.lang.Object
java.lang.Number
java.lang.Short
- 所有已实现的接口:
Serializable
,Comparable<Short>
,Constable
Short
类将原始类型 short
的值包装在一个对象中。 Short
类型的对象包含一个类型为 short
的字段。
此外,此类提供了几种将 short
转换为 String
和将 String
转换为 short
的方法,以及处理 short
时有用的其他常量和方法。
这是一个value-based类;程序员应该将 equal 的实例视为可互换的,并且不应使用实例进行同步,否则可能会发生不可预测的行为。例如,在未来的版本中,同步可能会失败。
- 自从:
- 1.1
- 参见:
-
字段摘要
字段 -
构造方法总结
构造方法 -
方法总结
修饰符和类型方法描述byte
在缩小基元转换后将此Short
的值作为byte
返回。static int
compare
(short x, short y) 以数字方式比较两个short
值。int
在数值上比较两个Short
对象。static int
compareUnsigned
(short x, short y) 比较两个short
值,在数值上将值视为无符号。static Short
将String
解码为Short
。返回包含此实例标称描述符的Optional
。double
在扩大基元转换后将此Short
的值作为double
返回。boolean
将此对象与指定对象进行比较。float
在扩大原始转换后将此Short
的值作为float
返回。int
hashCode()
返回此Short
的哈希码;等于调用intValue()
的结果。static int
hashCode
(short value) 返回short
值的哈希码;与Short.hashCode()
兼容。int
intValue()
在扩大基元转换后将此Short
的值作为int
返回。long
在扩大原始转换后将此Short
的值作为long
返回。static short
parseShort
(String s) 将字符串参数解析为带符号的十进制short
。static short
parseShort
(String s, int radix) 将字符串参数解析为第二个参数指定的基数中带符号的short
。static short
reverseBytes
(short i) 返回通过反转指定short
值的二进制补码表示中的字节顺序获得的值。short
将此Short
的值作为short
返回。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
返回一个Short
对象,其中包含由指定的String
给出的值。static Short
返回一个Short
对象,其中包含在使用第二个参数给出的基数进行解析时从指定的String
中提取的值。
-
字段详细信息
-
MIN_VALUE
public static final short MIN_VALUE一个保持最小值的常量 ashort
可以有,-215.- 参见:
-
MAX_VALUE
public static final short MAX_VALUE一个保持最大值的常量short
可以有,215-1.- 参见:
-
TYPE
代表原始类型short
的Class
实例。 -
SIZE
public static final int SIZE用于以二进制补码形式表示short
值的位数。- 自从:
- 1.5
- 参见:
-
BYTES
public static final int BYTES用于表示二进制补码形式的short
值的字节数。- 自从:
- 1.8
- 参见:
-
-
构造方法详细信息
-
Short
已弃用,将被删除:此 API 元素可能会在未来版本中删除。使用此构造函数很少是合适的。静态工厂valueOf(short)
通常是更好的选择,因为它可能会产生明显更好的空间和时间性能。构造一个新分配的Short
对象,表示指定的short
值。- 参数:
value
-Short
表示的值。
-
Short
已弃用,将被删除:此 API 元素可能会在未来版本中删除。构造一个新分配的Short
对象,该对象表示String
参数指示的short
值。字符串转换为short
值的方式与parseShort
方法用于基数 10 的方式完全相同。- 参数:
s
- 要转换为Short
的String
- 抛出:
NumberFormatException
- 如果String
不包含可解析的short
。
-
-
方法详情
-
toString
返回表示指定short
的新String
对象。假定基数为 10。- 参数:
s
- 要转换的short
- 返回:
-
指定
short
的字符串表示形式 - 参见:
-
parseShort
将字符串参数解析为第二个参数指定的基数中的有符号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
将字符串参数解析为带符号的十进制short
。字符串中的字符必须全部是十进制数字,除了第一个字符可以是 ASCII 减号'-'
('\u002D'
) 表示负值或 ASCII 加号'+'
('\u002B'
) 表示正值。返回生成的short
值,就像将参数和基数 10 作为参数提供给parseShort(java.lang.String, int)
方法一样。- 参数:
s
- 一个String
包含要解析的short
表示- 返回:
short
值由十进制参数表示。- 抛出:
NumberFormatException
- 如果字符串不包含可解析的short
。
-
valueOf
返回一个Short
对象,其中包含在使用第二个参数给出的基数进行解析时从指定的String
中提取的值。第一个参数被解释为表示第二个参数指定的基数中带符号的short
,就好像该参数被提供给parseShort(java.lang.String, int)
方法一样。结果是一个Short
对象,表示由字符串指定的short
值。换句话说,此方法返回一个
Short
对象,其值等于:new Short(Short.parseShort(s, radix))
- 参数:
s
- 要解析的字符串radix
- 用于解释s
的基数- 返回:
-
一个
Short
对象保存由指定基数中的字符串参数表示的值。 - 抛出:
NumberFormatException
- 如果String
不包含可解析的short
。
-
valueOf
返回一个Short
对象,其中包含由指定的String
给出的值。该参数被解释为表示带符号的十进制short
,就好像该参数被提供给parseShort(java.lang.String)
方法一样。结果是一个Short
对象,表示由字符串指定的short
值。换句话说,此方法返回一个
Short
对象,其值等于:new Short(Short.parseShort(s))
- 参数:
s
- 要解析的字符串- 返回:
-
一个
Short
对象保存由字符串参数表示的值 - 抛出:
NumberFormatException
- 如果String
不包含可解析的short
。
-
describeConstable
返回包含此实例标称描述符的Optional
。- 指定者:
describeConstable
在接口Constable
中- 返回:
Optional
描述了 Short 实例- 自从:
- 15
-
valueOf
返回代表指定short
值的Short
实例。如果不需要新的Short
实例,通常应优先使用此方法而不是构造函数Short(short)
,因为此方法可能会通过缓存频繁请求的值来产生明显更好的空间和时间性能。此方法将始终缓存 -128 到 127(含)范围内的值,并可能缓存此范围之外的其他值。- 参数:
s
- 短值。- 返回:
-
代表
s
的Short
实例。 - 自从:
- 1.5
-
decode
将String
解码为Short
。接受由以下语法给出的十进制、十六进制和八进制数:- 可解码字符串:
- 符号选择 DecimalNumeral
- 符号选择
0x
HexDigits - 符号选择
0X
HexDigits - 符号选择
#
HexDigits - 符号选择
0
OctalDigits - 符号:
-
+
可选符号和/或基数说明符(“
0x
”、“0X
”、“#
”或前导零)后面的字符序列由具有指定基数(10、16 或 8)的Short.parseShort
方法解析。此字符序列必须表示正值,否则将抛出NumberFormatException
。如果指定的String
的第一个字符是减号,则结果取反。String
中不允许有空白字符。- 参数:
nm
- 要解码的String
。- 返回:
-
一个
Short
对象持有由nm
表示的short
值 - 抛出:
NumberFormatException
- 如果String
不包含可解析的short
。- 参见:
-
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
-
hashCode
public int hashCode()返回此Short
的哈希码;等于调用intValue()
的结果。 -
hashCode
public static int hashCode(short value) 返回short
值的哈希码;与Short.hashCode()
兼容。- 参数:
value
- 要散列的值- 返回:
short
值的哈希码值。- 自从:
- 1.8
-
equals
将此对象与指定对象进行比较。当且仅当参数不是null
并且是包含与此对象相同的short
值的Short
对象时,结果为true
。 -
compareTo
在数值上比较两个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
值16.- 参数:
x
- 要转换为无符号int
的值- 返回:
-
通过无符号转换将参数转换为
int
- 自从:
- 1.8
-
toUnsignedLong
public static long toUnsignedLong(short x) 通过无符号转换将参数转换为long
。在到long
的无符号转换中,long
的高 48 位为零,低 16 位等于short
参数的位。因此,零和正short
值映射到数值上相等的long
值,负short
值映射到等于输入加 2 的long
值16.- 参数:
x
- 要转换为无符号long
的值- 返回:
-
通过无符号转换将参数转换为
long
- 自从:
- 1.8
-