python：array --- 高效的数值数组

注释：

由于平台的不同它可能为 16 位或 32 位。

在 3.9 版更改: array(‘u’) 现在使用 作为C类型，而不是被废弃的 Py_UNICODE 。这一变化并不影响它的行为，因为从Python 3.3开始， Py_UNICODE 就是 wchar_t 的别名。

从版本 3.3 开始标记为过时，将在版本 4.0 中移除。.
值的实际表示由机器体系结构（严格来说，由C实现）决定。可以通过array.itemsize属性访问实际大小。

模块定义了以下项：
array.typecodes
一个包含所有可用类型码的字符串。

这个模块定义了以下类型：

class array.array(typecode[, initializer])
一个包含由 typecode 限制类型的条目的新数组，并由可选的 initializer 值进行初始化，该值必须为一个列表、bytes-like object 或包含正确类型元素的可迭代对象。

如果给定一个列表或字符串，该 initializer 会被传给新数组的 fromlist(), frombytes() 或 fromunicode() 方法（见下文）以将初始条目添加到数组中。 否则会将可迭代对象作为 initializer 传给 extend() 方法。

数组对象支持普通的序列操作如索引、切片、拼接和重复等。 当使用切片赋值时，所赋的值必须为具有相同类型码的数组对象；所有其他情况都将引发 TypeError。 数组对象也实现了缓冲区接口，可以用于所有支持 字节类对象 的场合。

引发一个 审计事件 array.new 附带参数 typecode, initializer。

typecode
用于创建数组的类型码字符。

itemsize
在内部表示中一个数组项的字节长度。

append(x)
添加一个值为 x 的新项到数组末尾。

buffer_info()¶
返回一个元组（地址，长度），给出当前内存地址和用于保存数组内容的缓冲区元素的长度。内存缓冲区的大小（以字节为单位）可以计算为array.buffer_info（）[1]*array.itemsize。这在处理需要内存地址的低级（本质上是不安全的）I/O接口时有时很有用，例如某些ioctl（）操作。只要数组存在并且没有对其应用长度更改操作，返回的数字就有效。
备注 当在 C 或 C++ 编写的代码中使用数组对象时（这是有效使用此类信息的唯一方式），使用数组对象所支持的缓冲区接口更为适宜。 此方法仅保留用作向下兼容，应避免在新代码中使用。 缓冲区接口的文档参见 缓冲协议。
byteswap()
“字节对调”所有数组项。 此方法只支持大小为 1, 2, 4 或 8 字节的值；对于其他值类型将引发 RuntimeError。 它适用于从不同字节序机器所生成的文件中读取数据的情况。

count(x)
返回 x 在数组中的出现次数。

extend(iterable)
将来自 iterable 的项添加到数组末尾。 如果 iterable 是另一个数组，它必须具有 完全 相同的类型码；否则将引发 TypeError。 如果 iterable 不是一个数组，则它必须为可迭代对象并且其元素必须为可添加到数组的适当类型。

frombytes(s)
添加来自字节串的项，将字符节解读为机器值的数组（相当于使用 fromfile() 方法从文件中读取数据）。

3.2 新版功能: fromstring() is renamed to frombytes() for clarity.

fromfile(f, n)
从 file object f 中读取 n 项并将它们添加到数组末尾。 如果可用数据少于 n 项，则会引发 EOFError，但可用的项仍然会被插入数组。

fromlist(list)
添加来自 list 的项。 这等价于 for x in list: a.append(x)，区别在于如果发生类型错误，数组将不会被改变。

fromunicode(s)
使用来自给定 Unicode 字符串的数组扩展数组。 数组必须是类型为 ‘u’ 的数组；否则将引发 ValueError。 请使用 array.frombytes(unicodestring.encode(enc)) 来将 Unicode 数据添加到其他类型的数组。

index(x[, start[, stop]])
返回最小的 i 使得 i 为数组中首次出现的 x 的索引号。 指定可选参数 start 和 stop 以便在数组的一个子部分内部搜索 x。 如果未找到 x 则会引发 ValueError。

在 3.10 版更改: 添加了可选的 start 和 stop 形参。

insert(i, x)
将值 x 作为新项插入数组的 i 位置之前。 负值将被视为相对于数组末尾的位置。

pop([i])
从数组中移除序号为 i 的项并将其返回。 可选参数值默认为 -1，因此默认将移除并返回末尾项。

remove(x)
从数组中移除首次出现的 x。

reverse()
反转数组中各项的顺序。

tobytes()
将数组转换为一个机器值数组并返回其字节表示（即相当与通过 tofile() 方法写入到文件的字节序列。）

3.2 新版功能: tostring() is renamed to tobytes() for clarity.

tofile(f)
将所有项（作为机器值）写入到 file object f。

tolist()
将数组转换为包含相同项的普通列表。

tounicode()
将数组转换为一个 Unicode 字符串。 数组必须是类型为 ‘u’ 的数组；否则将引发 ValueError。 请使用 array.tobytes().decode(enc) 来从其他类型的数组生成 Unicode 字符串。

当一个数组对象被打印或转换为字符串时，它会表示为 array(typecode, initializer)。 如果数组为空则 initializer 会被省略，否则如果 typecode 为 ‘u’ 则它是一个字符串，否则它是一个数字列表。 使用 eval() 保证能将字符串转换回具有相同类型和值的数组，只要 array 类已通过 from array import array 被引入。 例如:

array('l')
array('u', 'hello \u2641')
array('l', [1, 2, 3, 4, 5])
array('d', [1.0, 2.0, 3.14])