array
– 数组¶
This module implements a subset of the corresponding CPython module,
as described below. For more information, refer to the original
CPython documentation: array
。
支持格式编码: b
, B
, h
, H
, i
, I
, l
, L
, q
, Q
, f
, d
(后两种依赖于浮点支持)。
类¶
- class array.array(typecode[, iterable])¶
使用给定类型的元素创建数组。数组的初始内容由 iterable 给定。若未给定内容,则创建一个空数组。
- append(val)¶
将 val 添加到数组末尾,并扩展数组。
- extend(iterable)¶
将包含在 iterable 中的新元素添加到数组末尾,并扩展数组。
- __getitem__(index)¶
通过索引读取数组,使用
a[index]
的形式调用(其中a
是一个array
)。如果 index 是一个int
,则返回一个值;如果 index 是一个切片,则返回一个array
。如果索引为负数,则从末尾计数,如果索引超出范围,则引发IndexError
。注意: 不能直接调用
__getitem__
(a.__getitem__(index)
会失败),也不在__dict__
中,但是a[index]
可以正常工作。
- __setitem__(index, value)¶
通过索引写入数组,使用
a[index] = value
的形式调用(其中a
是一个array
)。如果 index 是一个int
,则 value 是一个值;如果 index 是一个切片,则 value 是一个array
。如果索引为负数,则从末尾计数,如果索引超出范围,则引发IndexError
。注意: 不能直接调用
__setitem__
(a.__setitem__(index, value)
会失败),也不在__dict__
中,但是a[index] = value
可以正常工作。
- __len__()¶
返回数组中的项数,使用
len(a)
的形式调用(其中a
是一个array
)。注意: 不能直接调用
__len__
(a.__len__()
会失败),方法也不在__dict__
中,但是len(a)
可以正常工作。
- __add__(other)¶
返回一个新的
array
,它是数组与 other 的连接,使用a + other
的形式调用(其中a
和 other 都是arrays
)。注意: 不能直接调用
__add__
(a.__add__(other)
会失败),方法也不在__dict__
中,但是a + other
可以正常工作。
- __iadd__(other)¶
在原地将数组与 other 连接,使用
a += other
的形式调用(其中a
和 other 都是arrays
)。等效于extend(other)
。注意: 不能直接调用
__iadd__
(a.__iadd__(other)
会失败),方法也不在__dict__
中,但是a += other
可以正常工作。
- __repr__()¶
返回数组的字符串表示形式,使用
str(a)
或repr(a)
的形式调用(其中a
是一个array
)。返回字符串"array(<type>, [<elements>])"
,其中<type>
是数组的类型代码字母,<elements>
是数组的元素的逗号分隔列表。注意: 不能直接调用
__repr__
(a.__repr__()
会失败),也不在__dict__
中,但是str(a)
和repr(a)
都可以正常工作。