ByteUtil (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.util.ByteUtil

```
public class ByteUtil
extends Object
```
对数字和字节进行转换。
假设数据存储是以大端模式存储的：
- byte: 字节类型占8位二进制 00000000
- char: 字符类型占2个字节 16位二进制 byte[0] byte[1]
- int : 整数类型占4个字节 32位二进制 byte[0] byte[1] byte[2] byte[3]
- long: 长整数类型占8个字节 64位二进制 byte[0] byte[1] byte[2] byte[3] byte[4] byte[5]
- long: 长整数类型占8个字节 64位二进制 byte[0] byte[1] byte[2] byte[3] byte[4] byte[5] byte[6] byte[7]
- float: 浮点数(小数) 占4个字节 32位二进制 byte[0] byte[1] byte[2] byte[3]
- double: 双精度浮点数(小数) 占8个字节 64位二进制 byte[0] byte[1] byte[2] byte[3] byte[4]byte[5] byte[6] byte[7]
注：注释来自Hanlp，代码提供来自pr#1492@Github
Since:

5.6.3

Author:

looly, hanlp, FULaBUla

Field Summary

Fields
Modifier and Type Field and Description

static ByteOrder CPU_ENDIAN
CPU的字节序

static ByteOrder DEFAULT_ORDER
默认字节序：大端在前，小端在后

Fields
Modifier and Type	Field and Description
`static ByteOrder`	`CPU_ENDIAN` CPU的字节序
`static ByteOrder`	`DEFAULT_ORDER` 默认字节序：大端在前，小端在后

Constructor Summary

Constructors
Constructor and Description

ByteUtil()

Constructors
Constructor and Description
`ByteUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`bitCount(byte[] buf)` 统计byte中位数为1的个数
`static byte[]`	`concat(byte[]... byteArrays)` 连接多个byte[]
`static byte[]`	`fill(int intValue, int start, ByteOrder byteOrder, byte[] bytes)` 将int值转为bytes并填充到给定的bytes中
`static byte[]`	`fill(long longValue, int start, ByteOrder byteOrder, byte[] bytes)` 将long值转为bytes并填充到给定的bytes中
`static BigInteger`	`fromUnsignedByteArray(byte[] buf)` 无符号bytes转`BigInteger`
`static BigInteger`	`fromUnsignedByteArray(byte[] buf, int off, int length)` 无符号bytes转`BigInteger`
`static byte`	`toByte(int intValue)` int转byte
`static byte[]`	`toBytes(CharSequence str, Charset charset)` 编码字符串
`static byte[]`	`toBytes(double doubleValue)` double转byte数组默认以小端序转换
`static byte[]`	`toBytes(double doubleValue, ByteOrder byteOrder)` double转byte数组自定义端序 from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
`static byte[]`	`toBytes(float floatValue)` float转byte数组，默认以小端序转换
`static byte[]`	`toBytes(float floatValue, ByteOrder byteOrder)` float转byte数组，自定义端序
`static byte[]`	`toBytes(int intValue)` int转byte数组默认以小端序转换
`static byte[]`	`toBytes(int intValue, ByteOrder byteOrder)` int转byte数组自定义端序
`static byte[]`	`toBytes(long longValue)` long转byte数组默认以小端序转换 from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
`static byte[]`	`toBytes(long longValue, ByteOrder byteOrder)` long转byte数组自定义端序 from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
`static byte[]`	`toBytes(Number number)` 将`Number`转换为
`static byte[]`	`toBytes(Number number, ByteOrder byteOrder)` 将`Number`转换为
`static byte[]`	`toBytes(short shortValue)` short转byte数组默认以小端序转换
`static byte[]`	`toBytes(short shortValue, ByteOrder byteOrder)` short转byte数组自定义端序
`static double`	`toDouble(byte[] bytes)` byte数组转Double 默认以小端序转换
`static double`	`toDouble(byte[] bytes, ByteOrder byteOrder)` byte数组转double 自定义端序
`static float`	`toFloat(byte[] bytes)` byte数组转float 默认以小端序转换
`static float`	`toFloat(byte[] bytes, ByteOrder byteOrder)` byte数组转float 自定义端序
`static int`	`toInt(byte[] bytes)` byte[]转int值默认以小端序转换
`static int`	`toInt(byte[] bytes, ByteOrder byteOrder)` byte[]转int值自定义端序
`static int`	`toInt(byte[] bytes, int start, ByteOrder byteOrder)` byte[]转int值自定义端序
`static long`	`toLong(byte[] bytes)` byte数组转long 默认以小端序转换 from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
`static long`	`toLong(byte[] bytes, ByteOrder byteOrder)` byte数组转long 自定义端序 from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
`static long`	`toLong(byte[] bytes, int start, ByteOrder byteOrder)` byte数组转long 自定义端序 from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
`static <T extends Number> T`	`toNumber(byte[] bytes, Class<T> targetClass, ByteOrder byteOrder)` byte数组转换为指定类型数字
`static short`	`toShort(byte[] bytes)` byte数组转short 默认以小端序转换
`static short`	`toShort(byte[] bytes, ByteOrder byteOrder)` byte数组转short 自定义端序
`static short`	`toShort(byte[] bytes, int start, ByteOrder byteOrder)` byte数组转short 自定义端序
`static List<Integer>`	`toUnsignedBitIndex(byte[] bytes)` 统计无符号bytes转为bit位数为1的索引集合
`static byte[]`	`toUnsignedByteArray(BigInteger value)` 以无符号字节数组的形式返回传入值。
`static byte[]`	`toUnsignedByteArray(int length, BigInteger value)` 以无符号字节数组的形式返回传入值。
`static int`	`toUnsignedInt(byte byteValue)` byte转无符号int
`static byte[]`	`toUtf8Bytes(CharSequence str)` 编码字符串，编码为UTF-8

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_ORDER
```
public static final ByteOrder DEFAULT_ORDER
```
    默认字节序：大端在前，小端在后
  - CPU_ENDIAN
```
public static final ByteOrder CPU_ENDIAN
```
    CPU的字节序
- Constructor Detail
  - ByteUtil
```
public ByteUtil()
```
- Method Detail
  - toUtf8Bytes
```
public static byte[] toUtf8Bytes(CharSequence str)
```
    编码字符串，编码为UTF-8
    
    Parameters:
    
    str - 字符串
    
    Returns:
    
    编码后的字节码
  - toBytes
```
public static byte[] toBytes(CharSequence str,
                             Charset charset)
```
    编码字符串
    
    Parameters:
    
    str - 字符串
    
    charset - 字符集，如果此字段为空，则解码的结果取决于平台
    
    Returns:
    
    编码后的字节码
  - toByte
```
public static byte toByte(int intValue)
```
    int转byte
    
    Parameters:
    
    intValue - int值
    
    Returns:
    
    byte值
  - toBytes
```
public static byte[] toBytes(short shortValue)
```
    short转byte数组
    默认以小端序转换
    
    Parameters:
    
    shortValue - short值
    
    Returns:
    
    byte数组
  - toBytes
```
public static byte[] toBytes(short shortValue,
                             ByteOrder byteOrder)
```
    short转byte数组
    自定义端序
    
    Parameters:
    
    shortValue - short值
    
    byteOrder - 端序
    
    Returns:
    
    byte数组
  - toBytes
```
public static byte[] toBytes(int intValue)
```
    int转byte数组
    默认以小端序转换
    
    Parameters:
    
    intValue - int值
    
    Returns:
    
    byte数组
  - toBytes
```
public static byte[] toBytes(int intValue,
                             ByteOrder byteOrder)
```
    int转byte数组
    自定义端序
    
    Parameters:
    
    intValue - int值
    
    byteOrder - 端序
    
    Returns:
    
    byte数组
  - fill
```
public static byte[] fill(int intValue,
                          int start,
                          ByteOrder byteOrder,
                          byte[] bytes)
```
    将int值转为bytes并填充到给定的bytes中
    
    Parameters:
    
    intValue - int值
    
    start - 开始位置（包含）
    
    byteOrder - 端续
    
    bytes - 被填充的bytes
    
    Returns:
    
    填充后的bytes
    
    Since:
    
    6.0.0
  - toBytes
```
public static byte[] toBytes(long longValue)
```
    long转byte数组
    默认以小端序转换
    from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
    
    Parameters:
    
    longValue - long值
    
    Returns:
    
    byte数组
  - toBytes
```
public static byte[] toBytes(long longValue,
                             ByteOrder byteOrder)
```
    long转byte数组
    自定义端序
    from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
    
    Parameters:
    
    longValue - long值
    
    byteOrder - 端序
    
    Returns:
    
    byte数组
  - fill
```
public static byte[] fill(long longValue,
                          int start,
                          ByteOrder byteOrder,
                          byte[] bytes)
```
    将long值转为bytes并填充到给定的bytes中
    
    Parameters:
    
    longValue - long值
    
    start - 开始位置（包含）
    
    byteOrder - 端续
    
    bytes - 被填充的bytes
    
    Returns:
    
    填充后的bytes
    
    Since:
    
    6.0.0
  - toBytes
```
public static byte[] toBytes(float floatValue)
```
    float转byte数组，默认以小端序转换
    
    Parameters:
    
    floatValue - float值
    
    Returns:
    
    byte数组
    
    Since:
    
    5.7.18
  - toBytes
```
public static byte[] toBytes(float floatValue,
                             ByteOrder byteOrder)
```
    float转byte数组，自定义端序
    
    Parameters:
    
    floatValue - float值
    
    byteOrder - 端序
    
    Returns:
    
    byte数组
    
    Since:
    
    5.7.18
  - toBytes
```
public static byte[] toBytes(double doubleValue)
```
    double转byte数组
    默认以小端序转换
    
    Parameters:
    
    doubleValue - double值
    
    Returns:
    
    byte数组
  - toBytes
```
public static byte[] toBytes(double doubleValue,
                             ByteOrder byteOrder)
```
    double转byte数组
    自定义端序
    from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
    
    Parameters:
    
    doubleValue - double值
    
    byteOrder - 端序
    
    Returns:
    
    byte数组
  - toBytes
```
public static byte[] toBytes(Number number)
```
    将Number转换为
    
    Parameters:
    
    number - 数字
    
    Returns:
    
    bytes
  - toBytes
```
public static byte[] toBytes(Number number,
                             ByteOrder byteOrder)
```
    将Number转换为
    
    Parameters:
    
    number - 数字
    
    byteOrder - 端序
    
    Returns:
    
    bytes
  - toShort
```
public static short toShort(byte[] bytes)
```
    byte数组转short
    默认以小端序转换
    
    Parameters:
    
    bytes - byte数组
    
    Returns:
    
    short值
  - toShort
```
public static short toShort(byte[] bytes,
                            ByteOrder byteOrder)
```
    byte数组转short
    自定义端序
    
    Parameters:
    
    bytes - byte数组，长度必须为2
    
    byteOrder - 端序
    
    Returns:
    
    short值
  - toShort
```
public static short toShort(byte[] bytes,
                            int start,
                            ByteOrder byteOrder)
```
    byte数组转short
    自定义端序
    
    Parameters:
    
    bytes - byte数组，长度必须大于2
    
    start - 开始位置
    
    byteOrder - 端序
    
    Returns:
    
    short值
  - toInt
```
public static int toInt(byte[] bytes)
```
    byte[]转int值
    默认以小端序转换
    
    Parameters:
    
    bytes - byte数组
    
    Returns:
    
    int值
  - toInt
```
public static int toInt(byte[] bytes,
                        ByteOrder byteOrder)
```
    byte[]转int值
    自定义端序
    
    Parameters:
    
    bytes - byte数组
    
    byteOrder - 端序
    
    Returns:
    
    int值
  - toInt
```
public static int toInt(byte[] bytes,
                        int start,
                        ByteOrder byteOrder)
```
    byte[]转int值
    自定义端序
    
    Parameters:
    
    bytes - byte数组
    
    start - 开始位置（包含）
    
    byteOrder - 端序
    
    Returns:
    
    int值
    
    Since:
    
    5.7.21
  - toUnsignedInt
```
public static int toUnsignedInt(byte byteValue)
```
    byte转无符号int
    
    Parameters:
    
    byteValue - byte值
    
    Returns:
    
    无符号int值
    
    Since:
    
    3.2.0
  - toLong
```
public static long toLong(byte[] bytes)
```
    byte数组转long
    默认以小端序转换
    from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
    
    Parameters:
    
    bytes - byte数组
    
    Returns:
    
    long值
  - toLong
```
public static long toLong(byte[] bytes,
                          ByteOrder byteOrder)
```
    byte数组转long
    自定义端序
    from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
    
    Parameters:
    
    bytes - byte数组
    
    byteOrder - 端序
    
    Returns:
    
    long值
  - toLong
```
public static long toLong(byte[] bytes,
                          int start,
                          ByteOrder byteOrder)
```
    byte数组转long
    自定义端序
    from: https://stackoverflow.com/questions/4485128/how-do-i-convert-long-to-byte-and-back-in-java
    
    Parameters:
    
    bytes - byte数组
    
    start - 计算数组开始位置
    
    byteOrder - 端序
    
    Returns:
    
    long值
    
    Since:
    
    5.7.21
  - toFloat
```
public static float toFloat(byte[] bytes)
```
    byte数组转float
    默认以小端序转换
    
    Parameters:
    
    bytes - byte数组
    
    Returns:
    
    float值
    
    Since:
    
    5.7.18
  - toFloat
```
public static float toFloat(byte[] bytes,
                            ByteOrder byteOrder)
```
    byte数组转float
    自定义端序
    
    Parameters:
    
    bytes - byte数组
    
    byteOrder - 端序
    
    Returns:
    
    float值
    
    Since:
    
    5.7.18
  - toDouble
```
public static double toDouble(byte[] bytes)
```
    byte数组转Double
    默认以小端序转换
    
    Parameters:
    
    bytes - byte数组
    
    Returns:
    
    long值
  - toDouble
```
public static double toDouble(byte[] bytes,
                              ByteOrder byteOrder)
```
    byte数组转double
    自定义端序
    
    Parameters:
    
    bytes - byte数组
    
    byteOrder - 端序
    
    Returns:
    
    long值
  - toNumber
```
public static <T extends Number> T toNumber(byte[] bytes,
                                            Class<T> targetClass,
                                            ByteOrder byteOrder)
                                     throws IllegalArgumentException
```
    byte数组转换为指定类型数字
    
    Type Parameters:
    
    T - 数字类型
    
    Parameters:
    
    bytes - byte数组
    
    targetClass - 目标数字类型
    
    byteOrder - 端序
    
    Returns:
    
    转换后的数字
    
    Throws:
    
    IllegalArgumentException - 不支持的数字类型，如用户自定义数字类型
  - toUnsignedByteArray
```
public static byte[] toUnsignedByteArray(BigInteger value)
```
    以无符号字节数组的形式返回传入值。
    
    Parameters:
    
    value - 需要转换的值
    
    Returns:
    
    无符号bytes
    
    Since:
    
    4.5.0
  - toUnsignedByteArray
```
public static byte[] toUnsignedByteArray(int length,
                                         BigInteger value)
```
    以无符号字节数组的形式返回传入值。
    
    Parameters:
    
    length - bytes长度
    
    value - 需要转换的值
    
    Returns:
    
    无符号bytes
    
    Since:
    
    4.5.0
  - fromUnsignedByteArray
```
public static BigInteger fromUnsignedByteArray(byte[] buf)
```
    无符号bytes转BigInteger
    
    Parameters:
    
    buf - buf 无符号bytes
    
    Returns:
    
    BigInteger
    
    Since:
    
    4.5.0
  - fromUnsignedByteArray
```
public static BigInteger fromUnsignedByteArray(byte[] buf,
                                               int off,
                                               int length)
```
    无符号bytes转BigInteger
    
    Parameters:
    
    buf - 无符号bytes
    
    off - 起始位置
    
    length - 长度
    
    Returns:
    
    BigInteger
  - concat
```
public static byte[] concat(byte[]... byteArrays)
```
    连接多个byte[]
    
    Parameters:
    
    byteArrays - 多个byte[]
    
    Returns:
    
    连接后的byte[]
    
    Since:
    
    6.0.0
  - bitCount
```
public static int bitCount(byte[] buf)
```
    统计byte中位数为1的个数
    
    Parameters:
    
    buf - 无符号bytes
    
    Returns:
    
    为 1 的个数
    
    See Also:
    
    Integer.bitCount(int)
  - toUnsignedBitIndex
```
public static List<Integer> toUnsignedBitIndex(byte[] bytes)
```
    统计无符号bytes转为bit位数为1的索引集合
    
    Parameters:
    
    bytes - 无符号bytes
    
    Returns:
    
    位数为1的索引集合

Class ByteUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_ORDER

CPU_ENDIAN

Constructor Detail

ByteUtil

Method Detail

toUtf8Bytes

toBytes

toByte

toBytes

toBytes

toBytes

toBytes

fill

toBytes

toBytes

fill

toBytes

toBytes

toBytes

toBytes

toBytes

toBytes

toShort

toShort

toShort

toInt

toInt

toInt

toUnsignedInt

toLong

toLong

toLong

toFloat

toFloat

toDouble

toDouble

toNumber

toUnsignedByteArray

toUnsignedByteArray

fromUnsignedByteArray

fromUnsignedByteArray

concat

bitCount

toUnsignedBitIndex