# Python 的内置函数 bytearray

说明：类型转换为 bytearray。

bytearray 是可变的字节数组，拥有可变序列的大部分常见方法，请参考 list。

bytearray 也拥有不可变字节数组 bytes 的大部分常见方法。

# 函数说明

class bytearray(x=b''):
    '''
    创建 bytearray

    :param x: 要转换的变量
    :return: x 转换为 bytearray 后的值
    '''

!subtitle:说明

将变量转换为 bytearray 类型。

!subtitle:参数

• x - 要转换为 bytearray 的变量，默认为 b''，即创建一个空的 bytearray

  • 类型为 bytes 时拷贝该内容创建一个 bytearray

  • 类型为 int 时创建一个长度为 x 元素值全部为 0 的 bytearray

!subtitle:返回值

转换为 bytearray 后的值。

class bytearray(x, encoding):
    '''
    创建 bytearray

    :param x: 要转换的变量
    :param encoding: 编码
    :return: x 转换为 bytearray 后的值
    '''

!subtitle:说明

将变量转换为 bytearray 类型。

!subtitle:参数

• x - 要转换为 bytearray 的变量，通常是 str

• encoding - 转换时使用的编码

!subtitle:返回值

转换为 bytearray 后的值。

class bytearray(x, encoding, errors):
    '''
    创建 bytearray

    :param x: 要转换的变量
    :param encoding: 编码
    :param errors: 编码错误的处理方式
    :return: x 转换为 bytearray 后的值
    '''

!subtitle:说明

将变量转换为 bytearray 类型。

!subtitle:参数

• x - 要转换为 bytearray 的变量，通常是 str

• encoding - 转换时使用的编码

• errors - 编码错误的处理方式

!subtitle:返回值

转换为 bytearray 后的值。

# 编码错误的处理方式

• None 或 'strict' - 编码错误时产生 ValueError 异常

• 'ignore' - 忽略错误，通常会丢失数据

• 'replace' - 使用 '?' 替换有错误的位置

• 'surrogateescape' - 使用 U+DC08 至 U+DCFF 之间的值表示不正确的字节

• 'xmlcharrefreplace' - 编码格式不支持的字符将被替换为相应的 XML 字符引用，仅在写入时可用

• 'backslashreplace' - 使用反斜杠转义表示错误的数据

• 'namereplace' - 使用 \N{...} 转义表示错误的数据

# 示例

运行示例

print(bytearray(10))                            # 长度为 10，元素全部为全 0
print(bytearray(b'hello'))                      # from bytes
print(bytearray('hello', encoding='utf-8'))     # from str

# 推荐阅读

• Python 官方文档

• 内置函数 bytes

• 内置函数 list

• 内置函数 tuple