- java.lang.Object
-
- java.lang.Number
-
- java.lang.Short
-
- All Implemented Interfaces:
-
Serializable
,Comparable<Short>
public final class Short extends Number implements Comparable<Short>
Short
类包装一个对象中的原始类型short
的值。 类型为Short
的对象包含单个字段,其类型为short
。此外,该类还提供了一些将
short
转换为String
和String
转换为short
,以及在处理short
时有用的其他常量和方法。- 从以下版本开始:
- 1.1
- 另请参见:
-
Number
, Serialized Form
-
-
构造方法摘要
构造方法 Constructor 描述 Short(short value)
已过时。很少使用这个构造函数。 静态工厂valueOf(short)
通常是一个更好的选择,因为它可能产生明显更好的空间和时间性能。Short(String s)
已过时。很少使用这个构造函数。 使用parseShort(String)
将字符串转换为short
原语,或使用valueOf(String)
将字符串转换为Short
对象。
-
方法摘要
所有方法 静态方法 接口方法 具体的方法 Modifier and Type 方法 描述 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
。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)
返回一个新的String
对象,表示指定的short
。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
提取的值,当用第二个参数给出的基数进行解析时。
-
-
-
字段详细信息
-
MIN_VALUE
public static final short MIN_VALUE
的常量保持的最小值的short
可以具有,-2 15。- 另请参见:
- Constant Field Values
-
MAX_VALUE
public static final short MAX_VALUE
持有最大值a的常数ashort
可以具有2 15 -1。- 另请参见:
- Constant Field Values
-
SIZE
public static final int SIZE
用于表示二进制补码二进制形式的short
值的位数。- 从以下版本开始:
- 1.5
- 另请参见:
- Constant Field Values
-
BYTES
public static final int BYTES
用于表示二进制补码二进制形式的short
值的字节数。- 从以下版本开始:
- 1.8
- 另请参见:
- Constant Field Values
-
-
构造方法详细信息
-
Short
@Deprecated(since="9") public Short(short value)
构造新分配的Short
对象,该对象表示指定的short
值。- 参数
-
value
- 要由Short
表示的值。
-
Short
@Deprecated(since="9") public Short(String s) throws NumberFormatException
构造新分配的Short
对象,表示由String
参数指示的short
值。 字符串转换为short
值,完全符合基数10的parseShort
方法使用的方式。- 参数
-
s
-的String
转换为一个Short
- 异常
-
NumberFormatException
- 如果String
不包含可解析的short
。
-
-
方法详细信息
-
toString
public static String toString(short s)
返回一个新的String
对象,表示指定的short
。 基数假定为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
-所述String
含有short
表示被解析 -
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
- aString
其中包含要解析的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
对象的值等于:new Short(Short.parseShort(s, radix))
- 参数
-
s
- 要解析的字符串 -
radix
- 用于解释的基数s
- 结果
-
一个
Short
对象,其持有由指定基数中的字符串参数表示的值。 - 异常
-
NumberFormatException
- 如果String
不包含可解析的short
。
-
valueOf
public static Short valueOf(String s) throws NumberFormatException
返回一个持有由指定的String
给出的值的Short
对象。 该参数被解释为表示一个有符号的二进制short
,就好像这个参数被赋予了parseShort(java.lang.String)
方法一样。 结果是一个Short
对象,表示由字符串指定的short
值。换句话说,该方法返回一个
Short
对象的值等于:new Short(Short.parseShort(s))
- 参数
-
s
- 要解析的字符串 - 结果
-
一个
Short
对象,保存由string参数表示的值 - 异常
-
NumberFormatException
- 如果String
不包含可解析的short
。
-
valueOf
public static Short valueOf(short s)
返回表示short
值的Short
实例。 如果不需要新的Short
实例,则该方法通常优先于构造函数Short(short)
使用 ,因为该方法可能通过缓存经常请求的值而产生明显更好的空间和时间性能。 此方法将始终缓存-128到127(含)范围内的值,并可能会超出此范围之外的其他值。- 参数
-
s
- 一个很短的价值。 - 结果
-
一个
Short
实例,代表s
。 - 从以下版本开始:
- 1.5
-
decode
public static Short decode(String nm) throws NumberFormatException
将String
解码成Short
。 接受以下语法给出的十进制,十六进制和八进制数:- DecodableString:
- Signopt DecimalNumeral
-
Signopt
0x
HexDigits -
Signopt
0X
HexDigits -
Signopt
#
HexDigits -
Signopt
0
OctalDigits - Sign:
-
-
-
+
可选符号和/或基数说明符(“
0x
”,“0X
”,“#
”或前导零)之后的Short.parseShort
由具有指定基数(10,16或8)的Short.parseShort
方法解析。 这个字符序列必须表示一个正值,或者会抛出一个NumberFormatException
。 如果指定的String
第一个字符为负号,则结果将被取消。 在String
中不允许使用空格字符。- 参数
-
nm
- 要解码的String
。 - 结果
-
一个
Short
对象持有short
值代表nm
- 异常
-
NumberFormatException
- 如果String
不包含可解析的short
。 - 另请参见:
-
parseShort(java.lang.String, int)
-
byteValue
public byte byteValue()
返回此值Short
为byte
的基本收缩转换后。
-
shortValue
public short shortValue()
返回Short
的值作为short
。- 重写:
-
shortValue
在Number
- 结果
-
该对象在转换为
short
之后表示的数值。
-
intValue
public int intValue()
在扩展原始转换后,返回Short
的值作为int
。
-
longValue
public long longValue()
返回此值Short
为long
一个宽元转换后。
-
floatValue
public float floatValue()
在扩展原始转换后,返回Short
的值作为float
。- Specified by:
-
floatValue
在Number
- 结果
-
该对象在转换为
float
之后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
doubleValue
public double doubleValue()
返回此值Short
为double
一个宽元转换后。- Specified by:
-
doubleValue
在Number
- 结果
-
该对象在转换为
double
之后表示的数值。 - See The Java™ Language Specification:
- 5.1.2扩大原始转换
-
toString
public String toString()
返回一个表示Short
的值的String
对象。 该值被转换为带符号的十进制表示形式,并作为字符串返回,正如short
值被赋予toString(short)
方法的参数一样 。
-
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)
将此对象与指定的对象进行比较。 结果是true
当且仅当参数不是null
并且是一个Short
对象,其中包含与此对象相同的值为short
。- 重写:
-
equals
在Object
- 参数
-
obj
- 要比较的对象 - 结果
-
true
如果对象是相同的; 否则为false
。 - 另请参见:
-
Object.hashCode()
,HashMap
-
compareTo
public int compareTo(Short anotherShort)
以数字比较两个Short
对象。- Specified by:
-
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
; 一个值小于0
如果是x < y
; 和值大于0
如果x > y
- 从以下版本开始:
- 1.7
-
compareUnsigned
public static int compareUnsigned(short x, short y)
比较两个short
值,以数值方式将值视为无符号。- 参数
-
x
- 第一个short
进行比较 -
y
- 第二个short
进行比较 - 结果
-
价值
0
如果是x == y
; 一个值小于0
如果x < y
为无符号值; 并且如果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
,所述的高阶16位int
是零和低阶16个比特都等于的比特short
参数。 因此,零和正数short
值被映射到数字上相等的int
值,负short
值映射到等于输入加上2 16的int
值。- 参数
-
x
- 转换为无符号int
的值 - 结果
-
该参数通过无符号转换转换为
int
- 从以下版本开始:
- 1.8
-
toUnsignedLong
public static long toUnsignedLong(short x)
通过无符号转换将参数转换为long
。 在一个无符号转换为long
,所述的高阶48位long
是零和低阶16个比特都等于的比特short
参数。 因此,零和正值short
值被映射到数字上相等的long
值,而负short
值被映射到等于输入加上2 16的long
值。- 参数
-
x
- 转换为无符号long
的值 - 结果
-
该参数通过无符号转换转换为
long
- 从以下版本开始:
- 1.8
-
-