array --- array dari data numerik

Modul ini mendefinisikan tipe array.array: urutan nilai yang hemat ruang dari satu tipe numerik tetap, dapat diindeks seperti list tetapi didukung oleh blok memori yang berdekatan yang dapat diakses melalui protokol buffer.

Kode tipe yang didukung

Argumen typecode karakter tunggal memilih tipe elemen:

Kode tipe

Tipe C

Byte

Tipe 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 or 4

int

'I'

unsigned int

2 or 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

Kode 'f' dan 'd' memerlukan firmware yang dibangun dengan dukungan floating-point (default pada sebagian besar board). Lebar tepat dari 'i' dan 'I' mengikuti ABI C host --- biasanya 4 byte pada port Cortex-M.

Kelas

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

Buat array dengan elemen dari tipe yang diberikan. Isi awal array diberikan oleh iterable. Jika tidak disediakan, array kosong dibuat.

Selain metode di bawah ini, objek array juga mengimplementasikan protokol buffer. Ini berarti isi seluruh array dapat diakses sebagai byte mentah melalui memoryview atau antarmuka lain yang menggunakan protokol ini.

append(val: Any) → None

Tambahkan elemen baru val ke akhir array, memperbesar ukurannya.

extend(iterable: Iterable) → None

Tambahkan elemen baru yang terdapat dalam iterable ke akhir array, memperbesar ukurannya.

__getitem__(index: int | slice) → Any

Bacaan berindeks dari array, dipanggil sebagai a[index] (di mana a adalah array). Mengembalikan nilai jika index adalah int dan array jika index adalah slice. Indeks negatif dihitung dari akhir dan IndexError dilempar jika indeks di luar jangkauan.

Catatan: __getitem__ tidak dapat dipanggil langsung (a.__getitem__(index) gagal) dan tidak ada dalam __dict__, namun a[index] berfungsi.

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

Penulisan berindeks ke dalam array, dipanggil sebagai a[index] = value (di mana a adalah array). value adalah nilai tunggal jika index adalah int dan array jika index adalah slice. Indeks negatif dihitung dari akhir dan IndexError dilempar jika indeks di luar jangkauan.

Catatan: __setitem__ tidak dapat dipanggil langsung (a.__setitem__(index, value) gagal) dan tidak ada dalam __dict__, namun a[index] = value berfungsi.

__len__() → int

Mengembalikan jumlah item dalam array, dipanggil sebagai len(a) (di mana a adalah array).

Catatan: __len__ tidak dapat dipanggil langsung (a.__len__() gagal) dan metode ini tidak ada dalam __dict__, namun len(a) berfungsi.

__add__(other: array) → array

Kembalikan array baru yang merupakan penggabungan array dengan other, dipanggil sebagai a + other (di mana a dan other keduanya adalah arrays).

Catatan: __add__ tidak dapat dipanggil langsung (a.__add__(other) gagal) dan tidak ada dalam __dict__, namun a + other berfungsi.

__iadd__(other: array) → array

Menggabungkan array dengan other di tempat, dipanggil sebagai a += other (di mana a dan other keduanya adalah arrays). Setara dengan extend(other).

Catatan: __iadd__ tidak dapat dipanggil langsung (a.__iadd__(other) gagal) dan tidak ada dalam __dict__, namun a += other berfungsi.

__repr__() → str

Mengembalikan representasi string dari array, dipanggil sebagai str(a) atau repr(a) (di mana a adalah array). Mengembalikan string "array(<type>, [<elements>])", di mana <type> adalah huruf kode tipe untuk array dan <elements> adalah daftar elemen array yang dipisahkan koma.

Catatan: __repr__ tidak dapat dipanggil langsung (a.__repr__() gagal) dan tidak ada dalam __dict__, namun str(a) dan repr(a) keduanya berfungsi.