模块  java.base
软件包  java.lang

Class Byte

  • 实现的所有接口
    SerializableComparable<Byte>

    public final class Byte
    extends Number
    implements Comparable<Byte>
    Byte类在对象中包装基本类型byte的值。 Byte类型的对象包含单个字段,其类型为byte

    此外,此类提供了几种将byte转换为StringString转换为byte ,以及在处理byte时有用的其他常量和方法。

    从以下版本开始:
    1.1
    另请参见:
    NumberSerialized Form
    • 字段汇总

      字段  
      变量和类型 字段 描述
      static int BYTES
      用于表示二进制补码二进制形式的 byte值的字节数。
      static byte MAX_VALUE
      持有 byte可以具有的最大值的常数,2 7 -1。
      static byte MIN_VALUE
      保持最小值的常数 byte可以具有-2 7
      static int SIZE
      用于表示二进制补码二进制形式的 byte值的位数。
      static <Byte> TYPE
      实例表示基本类型 byte
    • 构造方法摘要

      构造方法  
      构造器 描述
      Byte​(byte value)
      已过时。
      使用此构造函数很少是合适的。
      Byte​(String s)
      已过时。
      使用此构造函数很少是合适的。
    • 方法摘要

      所有方法  静态方法  实例方法 具体的方法 
      变量和类型 方法 描述
      byte byteValue()
      返回此值 Bytebyte
      static int compare​(byte x, byte y)
      以数字方式比较两个 byte值。
      int compareTo​(Byte anotherByte)
      以数字方式比较两个 Byte对象。
      static int compareUnsigned​(byte x, byte y)
      比较两个 byte值,以数值方式将值视为无符号。
      static Byte decode​(String nm)
      String解码为 Byte
      double doubleValue()
      在扩展基元转换后,将此 Byte的值作为 double返回。
      boolean equals​(Object obj)
      将此对象与指定的对象进行比较。
      float floatValue()
      返回此值 Bytefloat一个宽元转换后。
      int hashCode()
      返回此Byte的哈希码; 等于调用intValue()的结果。
      static int hashCode​(byte value)
      返回byte值的哈希码; Byte.hashCode()兼容。
      int intValue()
      返回此的值 Byte作为 int加宽原始转换之后。
      long longValue()
      返回此值 Bytelong一个宽元转换后。
      static byte parseByte​(String s)
      将字符串参数解析为带符号的十进制 byte
      static byte parseByte​(String s, int radix)
      将字符串参数解析为第二个参数指定的基数中的带符号 byte
      short shortValue()
      返回此值 Byteshort一个宽元转换后。
      String toString()
      返回表示此 Byte值的 String对象。
      static String toString​(byte b)
      返回表示指定的 byte的新 String对象。
      static int toUnsignedInt​(byte x)
      通过无符号转换将参数转换为 int
      static long toUnsignedLong​(byte x)
      通过无符号转换将参数转换为 long
      static Byte valueOf​(byte b)
      返回表示指定的 byte值的 Byte实例。
      static Byte valueOf​(String s)
      返回 Byte对象,其中包含指定的 String给定的值。
      static Byte valueOf​(String s, int radix)
      返回 Byte对象,当使用第二个参数给出的基数进行解析时,该对象保存从指定的 String提取的值。
    • 字段详细信息

      • MIN_VALUE

        public static final byte MIN_VALUE
        保持最小值a byte常数,-2 7
        另请参见:
        常数字段值
      • MAX_VALUE

        public static final byte MAX_VALUE
        持有 byte可以具有的最大值的常数,2 7 -1。
        另请参见:
        常数字段值
      • TYPE

        public static final <Byte> TYPE
        实例表示基本类型 byte
      • SIZE

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

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

      • Byte

        @Deprecated(since="9")
        public Byte​(byte value)
        Deprecated.
        It is rarely appropriate to use this constructor. The static factory valueOf(byte) is generally a better choice, as it is likely to yield significantly better space and time performance.
        构造一个新分配的 Byte对象,该对象表示指定的 byte值。
        参数
        value -值由表示 Byte
      • Byte

        @Deprecated(since="9")
        public Byte​(String s)
             throws NumberFormatException
        Deprecated.
        It is rarely appropriate to use this constructor. Use parseByte(String) to convert a string to a byte primitive, or use valueOf(String) to convert a string to a Byte object.
        构造一个新分配Byte对象,表示byte由指示值String参数。 该字符串parseByte方法用于基数10的方式转换为byte值。
        参数
        s -的 String ,以被转换为 Byte
        异常
        NumberFormatException - 如果 String不包含可分析的 byte
    • 方法详细信息

      • toString

        public static String toString​(byte b)
        返回表示指定的byte的新String对象。 假设基数为10。
        参数
        b - 要转换的 byte
        结果
        指定的 byte的字符串表示 byte
        另请参见:
        Integer.toString(int)
      • valueOf

        public static Byte valueOf​(byte b)
        返回表示指定的byte值的Byte实例。 如果不需要新的Byte实例,则通常应优先使用此方法,而不是构造函数Byte(byte) ,因为此方法可能会产生明显更好的空间和时间性能,因为所有字节值都被缓存。
        参数
        b - 字节值。
        结果
        Byte实例,代表 b
        从以下版本开始:
        1.5
      • parseByte

        public static byte parseByte​(String s,
                                     int radix)
                              throws NumberFormatException
        将字符串参数解析为第二个参数指定的基数中的带符号byte 字符串中的字符必须是数字指定基数的,(如通过确定是否Character.digit(char, int)返回一个非负的值)不同之处在于第一个字符可以是ASCII减号'-''\u002D' ),以指示一个负值或ASCII加号'+''\u002B' )表示正值。 返回结果byte值。

        如果发生以下任何一种情况,则抛出类型NumberFormatException的异常:

        • 第一个参数是null或者是长度为零的字符串。
        • 基数小于Character.MIN_RADIX或大于Character.MAX_RADIX
        • 字符串的任何字符不是指定基数的数字,所不同的是第一个字符可以是负号'-''\u002D' )或加号'+''\u002B' ),前提是所述字符串比长度1更长。
        • 字符串表示的值不是byte类型的值。
        参数
        s -所述 String含有 byte表示被解析
        radix - 解析 s使用的基数
        结果
        byte由指定基数中的字符串参数表示的值
        异常
        NumberFormatException - 如果字符串不包含可解析的 byte
      • parseByte

        public static byte parseByte​(String s)
                              throws NumberFormatException
        将字符串参数解析为带符号的十进制byte 字符串中的字符必须全部为十进制数字,除了第一个字符可以是ASCII减号'-''\u002D' )以指示负值或ASCII加号'+''\u002B' )以指示正值。 返回得到的byte值,就像参数和基数10作为parseByte(java.lang.String, int)方法的参数一样
        参数
        s -一个 String含有 byte表示被解析
        结果
        byte由十进制参数表示的值
        异常
        NumberFormatException - 如果字符串不包含可分析的 byte
      • valueOf

        public static Byte valueOf​(String s,
                                   int radix)
                            throws NumberFormatException
        返回Byte对象,当使用第二个参数给出的基数进行解析时,该对象保存从指定的String提取的值。 第一个参数被解释为表示由第二个参数指定的基数中的带符号byte ,就像该参数被赋予parseByte(java.lang.String, int)方法一样。 结果是Byte对象,表示字符串指定的byte值。

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

        new Byte(Byte.parseByte(s, radix))
        参数
        s - 要解析的字符串
        radix - 用于解释 s的基数
        结果
        Byte对象,保存指定基数中字符串参数表示的值。
        异常
        NumberFormatException - 如果 String不包含可分析的 byte
      • valueOf

        public static Byte valueOf​(String s)
                            throws NumberFormatException
        返回一个Byte对象,其中包含指定的String给出的值。 该参数被解释为表示带符号的十进制byte ,就像该参数被赋予parseByte(java.lang.String)方法一样。 结果是Byte对象,表示字符串指定的byte值。

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

        new Byte(Byte.parseByte(s))
        参数
        s - 要解析的字符串
        结果
        Byte对象,保存字符串参数表示的值
        异常
        NumberFormatException - 如果 String不包含可分析的 byte
      • decode

        public static Byte decode​(String nm)
                           throws NumberFormatException
        String解码为Byte 接受以下语法给出的十进制,十六进制和八进制数:
        DecodableString:
        Signopt DecimalNumeral
        Signopt 0x HexDigits
        Signopt 0X HexDigits
        Signopt # HexDigits
        Signopt 0 OctalDigits
        Sign:
        -
        +
        DecimalNumeralHexDigitsOctalDigitsThe Java™ Language Specification的 3.10.1节中定义 ,但数字之间不接受下划线。

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

        参数
        nm - 要解码的 String
        结果
        Byte对象, byte值为 nmnm表示
        异常
        NumberFormatException - 如果 String不包含可分析的 byte
        另请参见:
        parseByte(java.lang.String, int)
      • byteValue

        public byte byteValue()
        返回此值 Bytebyte
        重写:
        byteValueNumber
        结果
        转换为类型 byte后此对象表示的数值。
      • shortValue

        public short shortValue()
        在扩展基元转换后,将此 Byte的值作为 short返回。
        重写:
        shortValueNumber
        结果
        转换为类型 short后此对象表示的数值。
        See The Java™ Language Specification:
        5.1.2拓宽原始转换
      • intValue

        public int intValue()
        返回此的值 Byte作为 int加宽原始转换之后。
        Specified by:
        intValueNumber
        结果
        转换为类型 int后此对象表示的数值。
        See The Java™ Language Specification:
        5.1.2拓宽原始转换
      • longValue

        public long longValue()
        在扩展基元转换后,将此 Byte的值作为 long返回。
        Specified by:
        longValueNumber
        结果
        转换为类型 long后此对象表示的数值。
        See The Java™ Language Specification:
        5.1.2拓宽原始转换
      • floatValue

        public float floatValue()
        返回此值 Bytefloat一个宽元转换后。
        Specified by:
        floatValueNumber
        结果
        转换为类型 float后此对象表示的数值。
        See The Java™ Language Specification:
        5.1.2拓宽原始转换
      • doubleValue

        public double doubleValue()
        返回此值 Bytedouble一个宽元转换后。
        Specified by:
        doubleValueNumber
        结果
        转换为类型 double后此对象表示的数值。
        See The Java™ Language Specification:
        5.1.2拓宽原始转换
      • toString

        public String toString()
        返回表示此Byte值的String对象。 该值将转换为带符号的十进制表示形式并作为字符串返回,就像byte值作为toString(byte)方法的参数一样
        重写:
        toStringObject
        结果
        基数为10的该对象的值的字符串表示。
      • hashCode

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

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

        public int compareTo​(Byte anotherByte)
        以数字方式比较两个 Byte对象。
        Specified by:
        compareTo接口 Comparable<Byte>
        参数
        anotherByte - 要比较的 Byte
        结果
        0如果此Byte是等于参数Byte ; 的值小于0 ,如果这Byte在数值上小于该参数Byte ; 如果此Byte在数值上大于参数Byte (带符号的比较),则值大于0
        从以下版本开始:
        1.2
      • compare

        public static int compare​(byte x,
                                  byte y)
        以数字方式比较两个byte值。 返回的值与返回的值相同:
          Byte.valueOf(x).compareTo(Byte.valueOf(y)) 
        参数
        x - 第一个 byte进行比较
        y - 第二个 byte进行比较
        结果
        0如果x == y ; 如果值小于0则为x < y ; 和值大于0如果x > y
        从以下版本开始:
        1.7
      • compareUnsigned

        public static int compareUnsigned​(byte x,
                                          byte y)
        比较两个 byte值,以数值方式将值视为无符号。
        参数
        x - 第一个 byte进行比较
        y - 第二个 byte进行比较
        结果
        0如果x == y ; 如果x < y为无符号值,则小于0值; 如果x > y为无符号值,则值大于0
        从以下版本开始:
        9
      • toUnsignedInt

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

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