模块 java.base
 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 时有用的其他常量和方法。

这是一个value-based类;程序员应该将 equal 的实例视为可互换的,并且不应使用实例进行同步,否则可能会发生不可预测的行为。例如,在未来的版本中,同步可能会失败。

自从:
1.1
参见:
  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    static final int
    用于表示二进制补码形式的 short 值的字节数。
    static final short
    一个保持最大值的常量 short 可以有,215-1.
    static final short
    一个保持最小值的常量 a short 可以有,-215.
    static final int
    用于以二进制补码形式表示 short 值的位数。
    static final Class<Short>
    代表原始类型 shortClass 实例。
  • 构造方法总结

    构造方法
    构造方法
    描述
    Short(short value)
    已弃用,将被删除:此 API 元素可能会在未来版本中删除。
    使用此构造方法很少是合适的。
    已弃用,将被删除:此 API 元素可能会在未来版本中删除。
    使用此构造方法很少是合适的。
  • 方法总结

    修饰符和类型
    方法
    描述
    byte
    在缩小基元转换后将此 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
    String 解码为 Short
    返回包含此实例标称描述符的 Optional
    double
    在扩大基元转换后将此 Short 的值作为 double 返回。
    boolean
    equals(Object obj)
    将此对象与指定对象进行比较。
    float
    在扩大原始转换后将此 Short 的值作为 float 返回。
    int
    返回此 Short 的哈希码;等于调用 intValue() 的结果。
    static int
    hashCode(short value)
    返回 short 值的哈希码;与 Short.hashCode() 兼容。
    int
    在扩大基元转换后将此 Short 的值作为 int 返回。
    long
    在扩大原始转换后将此 Short 的值作为 long 返回。
    static short
    将字符串参数解析为带符号的十进制 short
    static short
    parseShort(String s, int radix)
    将字符串参数解析为第二个参数指定的基数中带符号的 short
    static short
    reverseBytes(short i)
    返回通过反转指定 short 值的二进制补码表示中的字节顺序获得的值。
    short
    将此 Short 的值作为 short 返回。
    返回表示此 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
    返回一个 Short 对象,其中包含由指定的 String 给出的值。
    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
      一个保持最小值的常量 a 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 值的位数。
      自从:
      1.5
      参见:
    • BYTES

      public static final int BYTES
      用于表示二进制补码形式的 short 值的字节数。
      自从:
      1.8
      参见:
  • 构造方法详细信息

    • Short

      @Deprecated (since ="9", forRemoval =true) public Short(short value)
      已弃用,将被删除:此 API 元素可能会在未来版本中删除。
      使用此构造函数很少是合适的。静态工厂 valueOf(short) 通常是更好的选择,因为它可能会产生明显更好的空间和时间性能。
      构造一个新分配的 Short 对象,表示指定的 short 值。
      参数:
      value - Short 表示的值。
    • Short

      @Deprecated (since ="9", forRemoval =true) public Short(String  s) throws NumberFormatException
      已弃用,将被删除:此 API 元素可能会在未来版本中删除。
      使用此构造函数很少是合适的。使用 parseShort(String) 将字符串转换为 short 基元,或使用 valueOf(String) 将字符串转换为 Short 对象。
      构造一个新分配的 Short 对象,该对象表示 String 参数指示的 short 值。字符串转换为 short 值的方式与 parseShort 方法用于基数 10 的方式完全相同。
      参数:
      s - 要转换为 ShortString
      抛出:
      NumberFormatException - 如果 String 不包含可解析的 short
  • 方法详情

    • toString

      public static String  toString(short s)
      返回表示指定 short 的新 String 对象。假定基数为 10。
      参数:
      s - 要转换的 short
      返回:
      指定 short 的字符串表示形式
      参见:
    • 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 - 一个 String 包含要解析的 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
      返回一个 Short 对象,其中包含由指定的 String 给出的值。该参数被解释为表示带符号的十进制 short ,就好像该参数被提供给 parseShort(java.lang.String) 方法一样。结果是一个 Short 对象,表示由字符串指定的 short 值。

      换句话说,此方法返回一个 Short 对象,其值等于:

      new Short(Short.parseShort(s))
      参数:
      s - 要解析的字符串
      返回:
      一个 Short 对象保存由字符串参数表示的值
      抛出:
      NumberFormatException - 如果 String 不包含可解析的 short
    • describeConstable

      public Optional <DynamicConstantDesc <Short >> describeConstable()
      返回包含此实例标称描述符的 Optional
      指定者:
      describeConstable 在接口 Constable
      返回:
      Optional 描述了 Short 实例
      自从:
      15
    • valueOf

      public static Short  valueOf(short s)
      返回代表指定 short 值的 Short 实例。如果不需要新的 Short 实例,通常应优先使用此方法而不是构造函数 Short(short) ,因为此方法可能会通过缓存频繁请求的值来产生明显更好的空间和时间性能。此方法将始终缓存 -128 到 127(含)范围内的值,并可能缓存此范围之外的其他值。
      参数:
      s - 短值。
      返回:
      代表 sShort 实例。
      自从:
      1.5
    • decode

      public static Short  decode(String  nm) throws NumberFormatException
      String 解码为 Short 。接受由以下语法给出的十进制、十六进制和八进制数:
      可解码字符串:
      符号选择 DecimalNumeral
      符号选择 0x HexDigits
      符号选择 0X HexDigits
      符号选择 # HexDigits
      符号选择 0 OctalDigits
      符号:
      -
      +
      DecimalNumeral, HexDigits, 和OctalDigits的定义见 3.10.1Java 语言规范, 除了数字之间不接受下划线。

      可选符号和/或基数说明符(“0x”、“0X”、“#”或前导零)后面的字符序列由具有指定基数(10、16 或 8)的 Short.parseShort 方法解析。此字符序列必须表示正值,否则将抛出 NumberFormatException 。如果指定的 String 的第一个字符是减号,则结果取反。 String 中不允许有空白字符。

      参数:
      nm - 要解码的 String
      返回:
      一个 Short 对象持有由 nm 表示的 short
      抛出:
      NumberFormatException - 如果 String 不包含可解析的 short
      参见:
    • 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
      返回:
      此对象的值以 10 为基数的字符串表示形式。
    • hashCode

      public int hashCode()
      返回此 Short 的哈希码;等于调用 intValue() 的结果。
      重写:
      hashCode 在类 Object
      返回:
      这个 Short 的哈希码值
      参见:
    • hashCode

      public static int hashCode(short value)
      返回 short 值的哈希码;与 Short.hashCode() 兼容。
      参数:
      value - 要散列的值
      返回:
      short 值的哈希码值。
      自从:
      1.8
    • equals

      public boolean equals(Object  obj)
      将此对象与指定对象进行比较。当且仅当参数不是 null 并且是包含与此对象相同的 short 值的 Short 对象时,结果为 true
      重写:
      equals 在类 Object
      参数:
      obj - 要与之比较的对象
      返回:
      true 如果对象相同; false否则。
      参见:
    • compareTo

      public int compareTo(Short  anotherShort)
      在数值上比较两个 Short 对象。
      指定者:
      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 ;如果 x < y 小于 0 的值;如果 x > y,则值大于 0
      自从:
      1.7
    • compareUnsigned

      public static int compareUnsigned(short x, short y)
      比较两个 short 值,在数值上将值视为无符号。
      参数:
      x - 第一个要比较的 short
      y - 要比较的第二个 short
      返回:
      0 如果 x == y ;如果 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。在到 int 的无符号转换中,int 的高 16 位为零,低 16 位等于 short 参数的位。因此,零和正 short 值映射到数值上相等的 int 值,负 short 值映射到等于输入加 2 的 int16.
      参数:
      x - 要转换为无符号 int 的值
      返回:
      通过无符号转换将参数转换为 int
      自从:
      1.8
    • toUnsignedLong

      public static long toUnsignedLong(short x)
      通过无符号转换将参数转换为 long。在到 long 的无符号转换中,long 的高 48 位为零,低 16 位等于 short 参数的位。因此,零和正 short 值映射到数值上相等的 long 值,负 short 值映射到等于输入加 2 的 long16.
      参数:
      x - 要转换为无符号 long 的值
      返回:
      通过无符号转换将参数转换为 long
      自从:
      1.8