Module  java.base
软件包  java.lang

Class Byte

  • All Implemented Interfaces:
    SerializableComparable<Byte>


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

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

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

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

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

      所有方法  静态方法  接口方法  具体的方法 
      Modifier and Type 方法 描述
      byte byteValue​()
      返回 Byte的值作为 byte
      static int compare​(byte x, byte y)
      数值比较两个 byte
      int compareTo​(Byte anotherByte)
      数字比较两个 Byte对象。
      static int compareUnsigned​(byte x, byte y)
      将两个 byte值进行比较, byte数值方式将值视为无符号。
      static Byte decode​(String nm)
      String解码成 Byte
      double doubleValue​()
      返回此值 Bytedouble一个宽元转换后。
      boolean equals​(Object obj)
      将此对象与指定的对象进行比较。
      float floatValue​()
      在扩展原始转换后,返回 Byte的值作为 float
      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)
      返回一个新 String表示指定对象 byte
      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
        另请参见:
        Constant Field Values
      • MAX_VALUE

        public static final byte MAX_VALUE
        一个持有最大值一个 byte可以有2 7 -1。
        另请参见:
        Constant Field Values
      • TYPE

        public static final Class<Byte> TYPE
        Class实例代表原始类型 byte
      • SIZE

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

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

      • Byte

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

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

      • toString

        public static String toString​(byte b)
        返回一个新的String对象,代表指定的byte 基数假定为10。
        参数
        b - 要转换的 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对象,保存由string参数表示的值
        异常
        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:
        -
        +
        DecimalNumeral,HexDigits,OctalDigits如在The Java™ Language Specification 3.10.1部分所定义,所不同的是下划线不数字之间接受。

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

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

        public byte byteValue​()
        返回 Byte的值作为 byte
        重写:
        byteValueNumber
        结果
        该对象在转换为 byte之后表示的数值。
      • shortValue

        public short shortValue​()
        返回此值 Byteshort一个宽元转换后。
        重写:
        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)
        将此对象与指定的对象进行比较。 结果是true当且仅当该参数不是null并且是一个Byte对象,其中包含与该对象相同的byte值。
        重写:
        equals在类 Object
        参数
        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 ; 和大于一个值0 ,如果这Byte在数值上大于该参数Byte (带符号的比较)。
        从以下版本开始:
        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