JavaTM 2 Platform
Standard Ed. 5.0

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, 序列化表格

字段摘要
static short MAX_VALUE
          保存 short 可取的最大值的常量,最大值为 215-1。
static short MIN_VALUE
          保存 short 可取的最小值的常量,最小值为 -215
static int SIZE
          用来以二进制补码形式表示 short 值的位数。
static Class<Short> TYPE
          表示基本类型 shortClass 实例。
 
构造方法摘要
Short(short value)
          构造一个新分配的 Short 对象,用来表示指定的 short 值。
Short(String s)
          构造一个新分配的 Short 对象,用来表示 String 参数所指示的 short 值。
 
方法摘要
 byte byteValue()
          以 byte 形式返回此 Short 的值。
 int compareTo(Short anotherShort)
          从数字上比较两个 Short 对象。
static Short decode(String nm)
          将 String 解码为 Short
 double doubleValue()
          以 double 形式返回此 Short 的值。
 boolean equals(Object obj)
          将此对象与指定对象比较。
 float floatValue()
          以 float 形式返回此 Short 的值。
 int hashCode()
          返回此 Short 的哈希码。
 int intValue()
          以 int 形式返回此 Short 的值。
 long longValue()
          以 Long 形式返回此 Short 的值。
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 Short valueOf(short s)
          返回表示指定 short 值的 Short 实例。
static Short valueOf(String s)
          返回一个保持指定 String 所给出的值的 Short 对象。
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
保存 short 可取的最小值的常量,最小值为 -215

另请参见:
常量字段值

MAX_VALUE

public static final short MAX_VALUE
保存 short 可取的最大值的常量,最大值为 215-1。

另请参见:
常量字段值

TYPE

public static final Class<Short> TYPE
表示基本类型 shortClass 实例。


SIZE

public static final int SIZE
用来以二进制补码形式表示 short 值的位数。

另请参见:
常量字段值
构造方法详细信息

Short

public Short(short value)
构造一个新分配的 Short 对象,用来表示指定的 short 值。

参数:
valueShort - 所表示的值。

Short

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

参数:
s - 要转换为 ShortString
抛出:
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 类型的异常:

参数:
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 值。
返回:
表示 sShort 实例。
从以下版本开始:
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:
-
DecimalNumeralHexDigitsOctalDigits 在《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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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