Module  java.base
软件包  java.lang

Class Short

  • All Implemented Interfaces:
    SerializableComparable<Short>


    public final class Short
    extends Number
    implements Comparable<Short>
    Short类包装一个对象中的原始类型short的值。 类型为Short的对象包含单个字段,其类型为short

    此外,该类还提供了一些将short转换为StringString转换为short ,以及在处理short时有用的其他常量和方法。

    从以下版本开始:
    1.1
    另请参见:
    NumberSerialized Form
    • Field Summary

      Fields  
      Modifier and Type Field 描述
      static int BYTES
      用于表示二进制补码二进制形式的 short值的字节数。
      static short MAX_VALUE
      持有最大值a的常数a short可以具有2 15 -1。
      static short MIN_VALUE
      的常量保持的最小值的 short可以具有,-2 15。
      static int SIZE
      用于表示二进制补码二进制形式的 short值的位数。
      static Class<Short> TYPE
      代表原始类型 shortClass实例。
    • 构造方法摘要

      构造方法  
      Constructor 描述
      Short​(short value)
      已过时。
      很少使用这个构造函数。 静态工厂valueOf(short)通常是一个更好的选择,因为它可能产生明显更好的空间和时间性能。
      Short​(String s)
      已过时。
      很少使用这个构造函数。 使用parseShort(String)将字符串转换为short原语,或使用valueOf(String)将字符串转换为Short对象。
    • 方法摘要

      所有方法  静态方法  接口方法  具体的方法 
      Modifier and Type 方法 描述
      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
      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)
      返回一个新的 String对象,表示指定的 short
      static int toUnsignedInt​(short x)
      通过无符号转换将参数转换为 int
      static long toUnsignedLong​(short x)
      通过无符号转换将参数转换为 long
      static Short valueOf​(short s)
      返回表示指定的 short值的 Short实例。
      static Short valueOf​(String s)
      返回一个 Short对象,保存由指定的 String给出的值。
      static Short valueOf​(String s, int radix)
      返回一个 Short对象,该对象保存从指定的 String提取的值,当用第二个参数给出的基数进行解析时。
    • 字段详细信息

      • MIN_VALUE

        public static final short MIN_VALUE
        的常量保持的最小值的 short可以具有,-2 15。
        另请参见:
        Constant Field Values
      • MAX_VALUE

        public static final short MAX_VALUE
        持有最大值a的常数a short可以具有2 15 -1。
        另请参见:
        Constant Field Values
      • TYPE

        public static final Class<Short> TYPE
        所述 Class实例表示基本类型 short
      • SIZE

        public static final int SIZE
        用于表示二进制补码二进制形式的 short值的位数。
        从以下版本开始:
        1.5
        另请参见:
        Constant Field Values
      • BYTES

        public static final int BYTES
        用于表示二进制补码二进制形式的 short值的字节数。
        从以下版本开始:
        1.8
        另请参见:
        Constant Field Values
    • 构造方法详细信息

      • Short

        @Deprecated(since="9")
        public Short​(short value)
        已过时。 很少使用这个构造函数。 静态工厂valueOf(short)通常是一个更好的选择,因为它可能产生明显更好的空间和时间性能。
        构造新分配的 Short对象,该对象表示指定的 short值。
        参数
        value - 要由 Short表示的值。
      • Short

        @Deprecated(since="9")
        public Short​(String s)
              throws NumberFormatException
        已过时。 很少使用这个构造函数。 使用parseShort(String)将字符串转换为short原语,或使用valueOf(String)将字符串转换为Short对象。
        构造新分配的Short对象,表示由String参数指示的short值。 字符串转换为short值,完全符合基数10的parseShort方法使用的方式。
        参数
        s -的 String转换为一个 Short
        异常
        NumberFormatException - 如果 String不包含可解析的 short
    • 方法详细信息

      • toString

        public static String toString​(short s)
        返回一个新的String对象,表示指定的short 基数假定为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 -所述 String含有 short表示被解析
        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 - a 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
        返回一个持有由指定的String给出的值的Short对象。 该参数被解释为表示一个有符号的二进制short ,就好像这个参数被赋予了parseShort(java.lang.String)方法一样。 结果是一个Short对象,表示由字符串指定的short值。

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

        new Short(Short.parseShort(s))
        参数
        s - 要解析的字符串
        结果
        一个 Short对象,保存由string参数表示的值
        异常
        NumberFormatException - 如果 String不包含可解析的 short
      • valueOf

        public static Short valueOf​(short s)
        返回表示short值的Short实例。 如果不需要新的Short实例,则该方法通常优先于构造函数Short(short)使用 ,因为该方法可能通过缓存经常请求的值而产生明显更好的空间和时间性能。 此方法将始终缓存-128到127(含)范围内的值,并可能会超出此范围之外的其他值。
        参数
        s - 一个很短的价值。
        结果
        一个 Short实例,代表 s
        从以下版本开始:
        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:
        -
        +
        DecimalNumeral,HexDigits,OctalDigits如在The Java™ Language Specification 3.10.1部分所定义,所不同的是下划线不数字之间接受。

        可选符号和/或基数说明符(“ 0x ”,“ 0X ”,“ # ”或前导零)之后的Short.parseShort由具有指定基数(10,16或8)的Short.parseShort方法解析。 这个字符序列必须表示一个正值,或者会抛出一个NumberFormatException 如果指定的String第一个字符为负号,则结果将被取消。 String中不允许使用空格字符。

        参数
        nm - 要解码的 String
        结果
        一个 Short对象持有 short值代表 nm
        异常
        NumberFormatException - 如果 String不包含可解析的 short
        另请参见:
        parseShort(java.lang.String, int)
      • byteValue

        public byte byteValue​()
        返回此值 Shortbyte的基本收缩转换后。
        重写:
        byteValueNumber
        结果
        该对象在转换为 byte之后表示的数值。
        See The Java™ Language Specification:
        5.1.3缩小原始转换
      • shortValue

        public short shortValue​()
        返回 Short的值作为 short
        重写:
        shortValueNumber
        结果
        该对象在转换为 short之后表示的数值。
      • intValue

        public int intValue​()
        在扩展原始转换后,返回 Short的值作为 int
        Specified by:
        intValueNumber
        结果
        该对象在转换为 int之后表示的数值。
        See The Java™ Language Specification:
        5.1.2扩大原始转换
      • longValue

        public long longValue​()
        返回此值 Shortlong一个宽元转换后。
        Specified by:
        longValueNumber
        结果
        该对象在转换为 long之后表示的数值。
        See The Java™ Language Specification:
        5.1.2扩大原始转换
      • floatValue

        public float floatValue​()
        在扩展原始转换后,返回 Short的值作为 float
        Specified by:
        floatValueNumber
        结果
        该对象在转换为 float之后表示的数值。
        See The Java™ Language Specification:
        5.1.2扩大原始转换
      • doubleValue

        public double doubleValue​()
        返回此值 Shortdouble一个宽元转换后。
        Specified by:
        doubleValueNumber
        结果
        该对象在转换为 double之后表示的数值。
        See The Java™ Language Specification:
        5.1.2扩大原始转换
      • toString

        public String toString​()
        返回一个表示Short的值的String对象。 该值被转换为带符号的十进制表示形式,并作为字符串返回,正如short值被赋予toString(short)方法的参数一样
        重写:
        toStringObject
        结果
        这个对象在基数10中的值的字符串表示。
      • hashCode

        public static int hashCode​(short value)
        返回一个short值的哈希码; 兼容Short.hashCode()
        参数
        value - 哈希值
        结果
        一个哈希码值为 short值。
        从以下版本开始:
        1.8
      • equals

        public boolean equals​(Object obj)
        将此对象与指定的对象进行比较。 结果是true当且仅当参数不是null并且是一个Short对象,其中包含与此对象相同的值为short
        重写:
        equalsObject
        参数
        obj - 要比较的对象
        结果
        true如果对象是相同的; 否则为false
        另请参见:
        Object.hashCode()HashMap
      • compareTo

        public int compareTo​(Short anotherShort)
        以数字比较两个 Short对象。
        Specified by:
        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 ; 一个值小于0如果是x < y ; 和值大于0如果x > y
        从以下版本开始:
        1.7
      • compareUnsigned

        public static int compareUnsigned​(short x,
                                          short y)
        比较两个 short值,以数值方式将值视为无符号。
        参数
        x - 第一个 short进行比较
        y - 第二个 short进行比较
        结果
        价值0如果是x == y ; 一个值小于0如果x < y为无符号值; 并且如果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 ,所述的高阶16位int是零和低阶16个比特都等于的比特short参数。 因此,零和正数short值被映射到数字上相等的int值,负short值映射到等于输入加上2 16int值。
        参数
        x - 转换为无符号 int的值
        结果
        该参数通过无符号转换转换为 int
        从以下版本开始:
        1.8
      • toUnsignedLong

        public static long toUnsignedLong​(short x)
        通过无符号转换将参数转换为long 在一个无符号转换为long ,所述的高阶48位long是零和低阶16个比特都等于的比特short参数。 因此,零和正值short值被映射到数字上相等的long值,而负short值被映射到等于输入加上2 16long值。
        参数
        x - 转换为无符号 long的值
        结果
        该参数通过无符号转换转换为 long
        从以下版本开始:
        1.8