array --- 数値データの配列

このモジュールは array.array 型を定義します。これは単一の固定された数値型の値を空間効率よく格納するシーケンスで、リストのようにインデックス指定できますが、連続したメモリブロックに格納され、バッファプロトコルを介してアクセスできます。

サポートされるタイプコード

1 文字の typecode 引数で要素の型を選択します:

タイプコード	C 型	バイト数	Python 型
'b'	signed char	1	int
'B'	unsigned char	1	int
'h'	signed short	2	int
'H'	unsigned short	2	int
'i'	signed int	2 または 4	int
'I'	unsigned int	2 または 4	int
'l'	signed long	4	int
'L'	unsigned long	4	int
'q'	signed long long	8	int
'Q'	unsigned long long	8	int
'f'	float	4	float
'd'	double	8	float

'f' と 'd' のコードには浮動小数点サポートを有効にしてビルドされたファームウェアが必要です（ほとんどのボードではデフォルトで有効です）。'i' と 'I' の正確な幅はホストの C ABI に従います --- 通常 Cortex-M ポートでは 4 バイトです。

クラス

class array.array(typecode: str, iterable: Iterable = ())

指定した型の要素を持つ配列を作成します。配列の初期内容は iterable で与えられます。指定しない場合、空の配列が作成されます。

以下のメソッドに加えて、array オブジェクトはバッファプロトコルも実装します。これは、配列全体の内容を memoryview またはこのプロトコルを使用する他のインターフェースを介して生のバイトとしてアクセスできることを意味します。

append(val: Any) → None

新しい要素 val を配列の末尾に追加し、配列を拡張します。

extend(iterable: Iterable) → None

iterable に含まれる新しい要素を配列の末尾に追加し、配列を拡張します。

__getitem__(index: int | slice) → Any

a[index]（a は array）として呼び出される、配列のインデックス読み取り。index が int の場合は値を返し、index がスライスの場合は array を返します。負のインデックスは末尾から数えられ、インデックスが範囲外の場合は IndexError が送出されます。

注: __getitem__ は直接呼び出すことができず（a.__getitem__(index) は失敗します）、__dict__ にも存在しませんが、a[index] は機能します。

__setitem__(index: int | slice, value: Any) → None

a[index] = value（a は array）として呼び出される、配列へのインデックス書き込み。index が int の場合 value は単一の値で、index がスライスの場合は array です。負のインデックスは末尾から数えられ、インデックスが範囲外の場合は IndexError が送出されます。

注: __setitem__ は直接呼び出すことができず（a.__setitem__(index, value) は失敗します）、__dict__ にも存在しませんが、a[index] = value は機能します。

__len__() → int

len(a)（a は array）として呼び出される、配列内の項目数を返します。

注: __len__ は直接呼び出すことができず（a.__len__() は失敗します）、このメソッドは __dict__ にも存在しませんが、len(a) は機能します。

__add__(other: array) → array

a + other（a と other はどちらも arrays）として呼び出される、配列と other を連結した新しい array を返します。

注: __add__ は直接呼び出すことができず（a.__add__(other) は失敗します）、__dict__ にも存在しませんが、a + other は機能します。

__iadd__(other: array) → array

a += other（a と other はどちらも arrays）として呼び出される、配列と other をインプレースで連結します。extend(other) と等価です。

注: __iadd__ は直接呼び出すことができず（a.__iadd__(other) は失敗します）、__dict__ にも存在しませんが、a += other は機能します。

__repr__() → str

str(a) または repr(a)（a は array）として呼び出される、配列の文字列表現を返します。"array(<type>, [<elements>])" という文字列を返します。ここで <type> は配列のタイプコード文字、<elements> は配列の要素をカンマで区切ったリストです。

注: __repr__ は直接呼び出すことができず（a.__repr__() は失敗します）、__dict__ にも存在しませんが、str(a) と repr(a) はどちらも機能します。