java.lang.Object

java.lang.Number

java.lang.Short

所有已实现的接口:: Serializable, Comparable<Short>, Constable

public final class Short extends Number implements Comparable<Short>, Constable

Short类将原始类型short的值包装在对象中。 Short类型的对象包含一个字段，其类型为short。

此外，该类提供了几种方法，用于将short转换为String，将String转换为short，以及在处理short时有用的其他常量和方法。

这是一个基于值的类; 程序员应将相等的实例视为可互换的，并且不应将实例用于同步，否则可能会发生不可预测的行为。例如，在将来的版本中，同步可能会失败。

自:

1.1

参见:

Field Summary

Fields

Modifier and Type

Field

Description

static final int

BYTES

用于以二进制补码形式表示short值所使用的字节数。

static final short

MAX_VALUE

一个常量，表示short可以具有的最大值，即2¹⁵-1。

static final short

MIN_VALUE

一个常量，表示short可以具有的最小值，即-2¹⁵。

static final int

SIZE

用于以二进制补码形式表示short值所使用的位数。

static final Class<Short>

TYPE

表示原始类型short的Class实例。
Constructor Summary

Constructors

Constructor

Description

Short(short value)

已弃用，将来会移除: 该API元素可能会在将来的版本中被移除。
很少适合使用此构造函数。

Short(String s)

已弃用，将来会移除: 该API元素可能会在将来的版本中被移除。
很少适合使用此构造函数。
Method Summary

Modifier and Type

Method

Description

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。

Optional<DynamicConstantDesc<Short>>

describeConstable()

返回一个包含此实例的名义描述符的Optional。

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)

返回表示指定short的新String对象。

static int

toUnsignedInt(short x)

通过无符号转换将参数转换为int。

static long

toUnsignedLong(short x)

通过无符号转换将参数转换为long。

static Short

valueOf(short s)

返回表示指定short值的Short实例。

static Short

valueOf(String s)

返回包含由指定String给定值的Short对象。

static Short

valueOf(String s, int radix)

返回包含由指定String解析为由第二个参数给定基数的值的Short对象。

Methods declared in class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details
- MIN_VALUE
  
  public static final short MIN_VALUE
  
  一个常量，表示short可以具有的最小值，即-2¹⁵。
  参见:
  
  Constant Field Values
- MAX_VALUE
  
  public static final short MAX_VALUE
  
  一个常量，表示short可以具有的最大值，即2¹⁵-1。
  参见:
  
  Constant Field Values
- TYPE
  
  public static final Class<Short> TYPE
  
  表示原始类型short的Class实例。
- SIZE
  
  public static final int SIZE
  
  用于以二进制补码形式表示short值所使用的位数。
  自:
  
  1.5
  
  参见:
  
  Constant Field Values
- BYTES
  
  public static final int BYTES
  
  用于以二进制补码形式表示short值所使用的字节数。
  自:
  
  1.8
  
  参见:
  
  Constant Field Values
Constructor Details
- Short
  
  @Deprecated(since="9", forRemoval=true) public Short(short value)
  
  Deprecated, for removal: This API element is subject to removal in a future version.
  It is rarely appropriate to use this constructor. The static factory valueOf(short) is generally a better choice, as it is likely to yield significantly better space and time performance.
  
  构造一个新分配的Short对象，表示指定的short值。
  
  参数:
  
  value - 要由Short表示的值。
- Short
  
  @Deprecated(since="9", forRemoval=true) public Short(String s) throws NumberFormatException
  
  Deprecated, for removal: This API element is subject to removal in a future version.
  It is rarely appropriate to use this constructor. Use parseShort(String) to convert a string to a short primitive, or use valueOf(String) to convert a string to a Short object.
  
  构造一个新分配的Short对象，表示由String参数指示的short值。该字符串将按照基数10的方式转换为short值，与parseShort方法的方式完全相同。
  
  参数:
  
  s - 要转换为Short的String
  
  抛出:
  
  NumberFormatException - 如果String不包含可解析的short。
Method Details
- toString
  
  public static String toString(short s)
  
  返回表示指定short的新String对象。基数假定为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 - 包含要解析为short的表示形式的String
  
  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 - 包含要解析为十进制表示形式的short的String
  
  返回:
  
  参数中表示的十进制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对象：
  
  Short.valueOf(Short.parseShort(s, radix))
  
  参数:
  
  s - 要解析的字符串
  
  radix - 用于解释s的基数
  
  返回:
  
  一个包含指定基数中字符串参数表示的值的Short对象。
  
  抛出:
  
  NumberFormatException - 如果String不包含可解析的short。
- valueOf
  
  public static Short valueOf(String s) throws NumberFormatException
  
  返回一个Short对象，该对象包含由指定String给出的值。该参数被解释为表示有符号十进制short，就好像参数被传递给parseShort(java.lang.String)方法一样。结果是一个代表由字符串指定的short值的Short对象。
  换句话说，该方法返回一个等于以下值的Short对象：
  
  Short.valueOf(Short.parseShort(s))
  
  参数:
  
  s - 要解析的字符串
  
  返回:
  
  一个包含字符串参数表示的值的Short对象
  
  抛出:
  
  NumberFormatException - 如果String不包含可解析的short。
- describeConstable
  
  public Optional<DynamicConstantDesc<Short>> describeConstable()
  
  返回一个包含此实例的名义描述符的Optional。
  
  指定者:
  
  describeConstable 在接口 Constable
  
  返回:
  
  一个描述Short实例的Optional
  
  自 JDK 版本:
  
  15
- valueOf
  
  public static Short valueOf(short s)
  
  返回一个表示指定short值的Short实例。如果不需要新的Short实例，则通常应优先使用此方法，而不是构造函数Short(short)，因为通过缓存频繁请求的值，此方法可能会获得明显更好的空间和时间性能。此方法将始终缓存范围在-128到127之间的值，并且可能会缓存此范围之外的其他值。
  
  参数:
  
  s - 一个short值
  
  返回:
  
  代表s的Short实例
  
  自 JDK 版本:
  
  1.5
- decode
  
  public static Short decode(String nm) throws NumberFormatException
  
  将一个String解码为一个Short。接受由以下语法给出的十进制、十六进制和八进制数字：
  
  可解码字符串:
  
  符号_可选十进制数
  
  符号_可选 0x 十六进制数字
  
  符号_可选 0X 十六进制数字
  
  符号_可选 # 十六进制数字
  
  符号_可选 0 八进制数字
  
  符号:
  
  -
  
  +
  
  十进制数、十六进制数字和八进制数字的定义如Java语言规范第3.10.1节中所定义的，但是在数字之间不接受下划线。
  在可选符号和/或基数指示符（"0x"、"0X"、"#"或前导零）之后的字符序列被解析为具有指定基数（10、16或8）的Short.parseShort方法。这些字符序列必须表示正值，否则将抛出NumberFormatException。如果指定的String的第一个字符是减号，则结果将被否定。在String中不允许有空白字符。
  参数:
  
  nm - 要解码的String
  
  返回:
  
  一个包含由nm表示的short值的Short对象
  
  抛出:
  
  NumberFormatException - 如果String不包含可解析的short。
  
  参见:
  
  parseShort(java.lang.String, int)
- 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
  
  public String toString()
  
  返回一个表示此Short值的String对象。该值被转换为有符号十进制表示并作为字符串返回，就好像将short值作为参数传递给toString(short)方法一样。
  
  覆盖:
  
  toString 在类 Object
  
  返回:
  
  以十进制为基数的此对象值的字符串表示。
- 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值的哈希码值。
  
  自 JDK 版本:
  
  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对象进行数字比较。
  
  指定者：
  
  compareTo 在接口中的 Comparable<Short>
  
  参数：
  
  anotherShort - 要比较的Short。
  
  返回：
  
  如果此Short等于参数Short则返回值为0; 如果此Short数值小于参数Short则返回值小于0; 如果此Short数值大于参数Short则返回值大于0（有符号比较）。
  
  自：
  
  1.2
- compare
  
  public static int compare(short x, short y)
  对两个short值进行数字比较。返回的值与以下内容相同：
  Short.valueOf(x).compareTo(Short.valueOf(y))
  参数：
  
  x - 要比较的第一个short
  
  y - 要比较的第二个short
  
  返回：
  
  如果x == y则返回值为0; 如果x < y则返回值小于0; 如果x > y则返回值大于0
  
  自：
  
  1.7
- compareUnsigned
  
  public static int compareUnsigned(short x, short y)
  
  对两个short值进行数字比较，将值视为无符号数。
  
  参数：
  
  x - 要比较的第一个short
  
  y - 要比较的第二个short
  
  返回：
  
  如果x == y则返回值为0; 如果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。在将short转换为无符号int时，int的高16位为零，低16位等于short参数的位。因此，零和正short值被映射为数值相等的int值，而负short值被映射为等于输入加2¹⁶的int值。
  
  参数：
  
  x - 要转换为无符号int的值
  
  返回：
  
  通过无符号转换将参数转换为int
  
  自：
  
  1.8
- toUnsignedLong
  
  public static long toUnsignedLong(short x)
  
  通过无符号转换将参数转换为long。在将short转换为无符号long时，long的高48位为零，低16位等于short参数的位。因此，零和正short值被映射为数值相等的long值，而负short值被映射为等于输入加2¹⁶的long值。
  
  参数：
  
  x - 要转换为无符号long的值
  
  返回：
  
  通过无符号转换将参数转换为long
  
  自：
  
  1.8

Class Short

Field Summary

Constructor Summary

Method Summary

Methods declared in class java.lang.Object

Field Details

MIN_VALUE

MAX_VALUE

TYPE

SIZE

BYTES

Constructor Details

Short

Short

Method Details

toString

parseShort

parseShort

valueOf

valueOf

describeConstable

valueOf

decode

byteValue

shortValue

intValue

longValue

floatValue

doubleValue

toString

hashCode

hashCode

equals

compareTo

compare

compareUnsigned

reverseBytes

toUnsignedInt

toUnsignedLong