java.lang
类 Short

java.lang.Object
  java.lang.Number
      java.lang.Short

所有已实现的接口：

Serializable, Comparable<Short>

public final class Short
extends Number
implements Comparable<Short>

Short 类在对象中包装基本类型 short 的值。一个 Short 类型的对象只包含一个 short 类型的字段。

另外，该类提供了多个方法，可以将 short 转换为 String，将 String 转换为 short，同时还提供了其他一些处理 short 时有用的常量和方法。

从以下版本开始：

JDK1.1

另请参见：

Number, 序列化表格

MIN_VALUE

public static final short MIN_VALUE

保存 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

另请参见：

常量字段值

Short

public Short(short value)

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

参数：

valueShort - 所表示的值。

Short

public Short(String s)
      throws NumberFormatException

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

参数：

s - 要转换为 Short 的 String

抛出：

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

另请参见：

parseShort(java.lang.String, int)

toString

public static String toString(short s)

返回表示指定 short 的一个新 String 对象。假定用十进制表示。

参数：

s - 所要转换的 short

返回：

表示指定 short 的字符串

另请参见：

Integer.toString(int)

parseShort

public static short parseShort(String s)
                        throws NumberFormatException

将字符串参数解析为有符号的十进制 short。该字符串中的字符必须都是十进制数字，除非第一个字符是表示负值的 ASCII 符号中的负号 '-' ('\u002D')。返回得到的 short 值，此值与用该参数和基数 10 作为参数的 parseShort(java.lang.String, int) 方法得到的值相同。

参数：

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

返回：

参数（十进制）表示的 short 值。

抛出：

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

parseShort

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

将字符串参数解析为由第二个参数指定的基数中的有符号的 short。该字符串中的字符必须都是指定基数（这取决于 Character.digit(char, int) 是否返回非负值）的数字，除非第一个字符是表示负值的 ASCII 符号中的负号 “-” ('\u002D')。返回得到的 byte 值。

如果出现以下情形之一，则抛出 NumberFormatException 类型的异常：

• 第一个参数是 null 或零长度的字符串。
• 基数小于 Character.MIN_RADIX 或大于 Character.MAX_RADIX。
• 除了在字符串长度超过 1 的情况下第一个字符可能是负号 “-” ('\u002D') 之外，字符串的任何字符都不是指定基数的数字。
• 字符串所表示的值不是 short 类型的值。

参数：

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

radix - 将在解析 s 时使用的基数

返回：

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

抛出：

NumberFormatException - 如果 String 不包含可解析的 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，此值与用该参数作为参数的 #parseLong(java.lang.String) 方法得到的值相同。结果是一个表示该字符串所指定的 short 值的 Short 对象。

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

new Short(Short.parseShort(s))

参数：

s - 要解析的字符串

返回：

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

抛出：

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

valueOf

public static Short valueOf(short s)

返回表示指定 short 值的 Short 实例。如果不需要新的 Short 实例，则通常应该优先采用此方法，而不是构造方法 Short(short)，因为此方法很可能通过缓存经常请求的值来显著提高空间和时间性能。

参数：

s - 一个 short 值。

返回：

表示 s 的 Short 实例。

从以下版本开始：

1.5

decode

public static Short decode(String nm)
                    throws NumberFormatException

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

DecodableString:

Sign_opt DecimalNumeral

Sign_opt 0x HexDigits

Sign_opt 0X HexDigits

Sign_opt # HexDigits

Sign_opt 0 OctalDigits

Sign:

-

DecimalNumeral、HexDigits 和 OctalDigits 在 Java Language Specification 的 §3.10.1 中已经定义。

对（可选）负号和/或基数说明符（“0x”、“0X”、“#” 或前导零）后面的字符序列进行解析就如同用 Short.parseByte 方法来解析指定的基数（10、16 或 8）一样。该字符序列必须表示为一个正值，否则将抛出 NumberFormatException。如果指定 String 的第一个字符是减号，则结果无效。String 中不允许出现空白字符。

参数：

nm - 要解码的 String。

返回：

保持 nm 所表示的 short 值的 Short 对象

抛出：

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

另请参见：

parseShort(java.lang.String, int)

byteValue

public byte byteValue()

以 byte 形式返回此 Short 的值。

覆盖：

类 Number 中的 byteValue

返回：

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

shortValue

public short shortValue()

以 short 形式返回此 Short 的值。

覆盖：

类 Number 中的 shortValue

返回：

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

intValue

public int intValue()

以 int 形式返回此 Short 的值。

指定者：

类 Number 中的 intValue

返回：

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

longValue

public long longValue()

以 Long 形式返回此 Short 的值。

指定者：

类 Number 中的 longValue

返回：

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

floatValue

public float floatValue()

以 float 形式返回此 Short 的值。

指定者：

类 Number 中的 floatValue

返回：

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

doubleValue

public double doubleValue()

以 double 形式返回此 Short 的值。

指定者：

类 Number 中的 doubleValue

返回：

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

toString

public String toString()

返回表示此 Short 的值的 String 对象。该值被转换成有符号的十进制表示形式，并作为一个字符串返回，正如将 short 值作为一个参数指定给 toString(short) 方法所得到的值那样。

覆盖：

类 Object 中的 toString

返回：

该对象值（十进制）的字符串表示形式。

hashCode

public int hashCode()

返回此 Short 的哈希码。

覆盖：

类 Object 中的 hashCode

返回：

此对象的一个哈希码值。

另请参见：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

将此对象与指定对象比较。当且仅当参数不是 null，而是一个与该对象一样包含相同 short 值的 Short 对象时，结果才为 true。

覆盖：

类 Object 中的 equals

参数：

obj - 将与之进行比较的对象。

返回：

如果这些对象相同，则返回 true；否则返回 false。

另请参见：

Object.hashCode(), Hashtable

compareTo

public int compareTo(Short anotherShort)

比较两个 Short 对象所表示的数值。

指定者：

接口 Comparable<Short> 中的 compareTo

参数：

anotherShort - 要比较的 Short。

返回：

如果该 Short 等于参数 Short，则返回 0；如果该 Short 数值小于参数 Short，则返回小于 0 的值；如果该 Short 数值大于参数 Short，则返回大于 0 的值（有符号比较）。

从以下版本开始：

1.2

reverseBytes

public static short reverseBytes(short i)

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

返回：

返回通过反转（或者交换，效果相同）指定 short 值中的字节而获得的值。

从以下版本开始：

1.5

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。