array — 숫자 데이터의 배열

이 모듈은 array.array 유형을 정의합니다: 단일 고정 숫자 유형의 값으로 이루어진 공간 효율적인 시퀀스로, 리스트처럼 인덱싱할 수 있지만 버퍼 프로토콜을 통해 접근 가능한 연속된 메모리 블록으로 뒷받침됩니다.

지원되는 유형 코드

단일 문자 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)는 모두 동작합니다.