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 |
public static final int BYTES
用于以二进制补码形式表示短值的字节数。
public static final short MAX_VALUE
一个保持空头可以拥有的最大值的常数,215-1。
public static final short MIN_VALUE
一个保持空头可以拥有的最小值的常数,-215。
public static final int SIZE
用于以二进制补码形式表示短值的位数。
public static final ClassShort TYPE
表示原始类型 short 的 Class 实例。
public Short(short value)
构造一个新分配的 Short 对象,该对象表示指定的 short 值。
参数:
参数名称 | 参数描述 |
---|---|
value | Short 要表示的值。 |
public Short(String s) throws NumberFormatException
构造一个新分配的 Short 对象,该对象表示由 String 参数指示的 short 值。 字符串转换为短值的方式与基数 10 的 parseShort 方法使用的方式完全相同。
参数:
参数名称 | 参数描述 |
---|---|
s | 要转换为 Short 的 String |
Throws:
Throw名称 | Throw描述 |
---|---|
NumberFormatException | 如果字符串不包含可解析的短。 |
public static String toString(short s)
返回一个表示指定短的新字符串对象。 基数假定为 10。
参数:
参数名称 | 参数描述 |
---|---|
s | 要转换的short |
返回:
指定短的字符串表示
public static short parseShort(String s, int radix) throws NumberFormatException
将字符串参数解析为第二个参数指定的基数中的有符号短整数。 字符串中的字符必须都是指定基数的数字(取决于 Character.digit(char, int) 是否返回非负值),但第一个字符可能是 ASCII 减号 "-" ("u002D ") 表示负值或 ASCII 加号 "+" ("u002B") 表示正值。 返回结果的短值。
如果发生以下任何一种情况,则会引发 NumberFormatException 类型的异常:
参数:
参数名称 | 参数描述 |
---|---|
s | 包含要解析的短表示的字符串 |
radix | 解析 s 时要使用的基数 |
返回:
由指定基数中的字符串参数表示的short。
Throws:
Throw名称 | Throw描述 |
---|---|
NumberFormatException | 如果字符串不包含可解析的short。 |
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。 |
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。 |
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。 |
public static Short valueOf(short s)
返回一个表示指定短值的 Short 实例。 如果不需要新的 Short 实例,则通常应优先使用此方法而不是构造函数 Short(short),因为此方法可能会通过缓存频繁请求的值来显着提高空间和时间性能。 此方法将始终缓存 -128 到 127(含)范围内的值,并且可能缓存此范围之外的其他值。
参数:
参数名称 | 参数描述 |
---|---|
s | a short value. |
返回:
表示 s 的 Short 实例。
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。 |
public byte byteValue()
在缩小原语转换后,将此 Short 的值作为字节返回。
覆盖:
类 Number 中的 byteValue
返回:
此对象在转换为字节类型后表示的数值。
public short shortValue()
将此 Short 的值作为 short 返回。
覆盖:
类 Number 中的 shortValue
返回:
此对象在转换为 short 类型后表示的数值。
public int intValue()
在扩展原始转换后,将此 Short 的值作为 int 返回。
指定者:
类 Number 中的 intValue
返回:
此对象在转换为 int 类型后表示的数值。
public long longValue()
在扩展原始转换后将此 Short 的值作为 long 返回。
指定者:
类 Number 中的 longValue
返回:
此对象在转换为 long 类型后表示的数值。
public float floatValue()
在扩大原始转换后,将此 Short 的值作为浮点数返回。
指定者:
类 Number 中的 floatValue
返回:
此对象在转换为 float 类型后表示的数值。
public double doubleValue()
在扩展原始转换之后,将此 Short 的值作为双精度值返回。
指定者:
类 Number 中的 doubleValue
返回:
此对象在转换为 double 类型后表示的数值。
public String toString()
返回表示此 Short 值的 String 对象。 该值被转换为带符号的十进制表示形式并以字符串形式返回,就像将 short 值作为参数提供给 toString(short) 方法一样。
覆盖:
类 Object 中的 toString
返回:
以 10 为基数的此对象值的字符串表示形式。
public int hashCode()
返回此 Short 的哈希码; 等于调用 intValue() 的结果。
覆盖:
类 Object 中的 hashCode
返回:
此 Short 的哈希码值
public static int hashCode(short value)
返回short值的哈希码; 与 Short.hashCode() 兼容。
参数:
参数名称 | 参数描述 |
---|---|
value | 哈希值 |
返回:
short值的哈希码值。
public boolean equals(Object obj)
将此对象与指定对象进行比较。 当且仅当参数不为 null 并且是包含与此对象相同的 short 值的 Short 对象时,结果才为真。
覆盖:
类 Object 中的等于
参数:
参数名称 | 参数描述 |
---|---|
obj | 比较的对象 |
返回:
如果对象相同,则为 true; 否则为 false。
public int compareTo(Short anotherShort)
以数字方式比较两个 Short 对象。
指定者:
接口 ComparableShort 中的 compareTo
参数:
参数名称 | 参数描述 |
---|---|
anotherShort | the Short to be compared. |
返回:
如果此 Short 等于参数 Short,则值为 0; 如果此 Short 在数值上小于参数 Short,则值小于 0; 如果此 Short 在数值上大于参数 Short(有符号比较),则值大于 0。
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
public static short reverseBytes(short i)
返回通过反转指定短值的二进制补码表示中的字节顺序获得的值。
参数:
参数名称 | 参数描述 |
---|---|
i | 要反转其字节的值 |
返回:
通过反转(或等效地,交换)指定短值中的字节获得的值。
public static int toUnsignedInt(short x)
通过无符号转换将参数转换为 int。 在到 int 的无符号转换中,int 的高 16 位为零,低 16 位等于 short 参数的位。 因此,零和正短值映射到数值相等的 int 值,负短值映射到等于输入加 216 的 int 值。
参数:
参数名称 | 参数描述 |
---|---|
x | 要转换为无符号整数的值 |
返回:
通过无符号转换转换为 int 的参数
public static long toUnsignedLong(short x)
通过无符号转换将参数转换为 long。 在到 long 的无符号转换中,long 的高 48 位为零,低 16 位等于 short 参数的位。 因此,零和正短值映射到数值相等的长值,负短值映射到等于输入加 216 的长值。
参数:
参数名称 | 参数描述 |
---|---|
x | 要转换为无符号长整数的值 |
返回:
通过无符号转换转换为 long 的参数
NoSuchFieldExceptionjava.lang.Object |---java.lang.Throwable |---|---java.lang.Exception |---|---|---java.lang.Reflectiv...
Errorjava.lang.Object |---java.lang.Throwable |---|---java.lang.Errorpublic class Errorextends ThrowableError 是 Throwab...
NoSuchFieldErrorjava.lang.Object |---java.lang.Throwable |---|---java.lang.Error |---|---|---java.lang.LinkageError |---...
VerifyErrorjava.lang.Object |---java.lang.Throwable |---|---java.lang.Error |---|---|---java.lang.LinkageError |---|---|...