builtins — 내장 함수 및 예외

모든 내장 함수와 예외가 여기에 설명되어 있습니다. 이들은 builtins 모듈을 통해서도 사용할 수 있습니다.

함수 및 타입

abs(x: Any) Any

숫자의 절댓값을 반환합니다. 인자는 정수, 부동 소수점 수, 또는 __abs__()를 구현한 임의의 객체일 수 있습니다.

all(iterable: Iterable[Any]) bool

iterable의 모든 요소가 참이면(또는 iterable이 비어 있으면) True를 반환합니다.

any(iterable: Iterable[Any]) bool

iterable의 요소 중 하나라도 참이면 True를 반환합니다. iterable이 비어 있으면 False를 반환합니다.

bin(x: int) str

정수를 "0b"로 시작하는 2진수 문자열로 변환합니다. 인자는 Python 정수이거나 __index__()를 구현해야 합니다.

class bool(x: Any = False)

불리언 값, 즉 True 또는 False 중 하나를 반환합니다. x는 표준 진리값 검사 절차를 사용하여 변환됩니다.

class bytearray(source: int | str | Iterable[int] | bytes = b'', encoding: str = 'utf-8', errors: str = 'strict')

0-255 범위의 정수로 이루어진 가변 시퀀스입니다. 생성 방법은 bytes와 동일한 규칙을 따릅니다. 즉 정수로부터(해당 크기의 0으로 채워진 버퍼 생성), 정수의 iterable로부터, encoding을 지정한 문자열로부터, 또는 버퍼 프로토콜을 지원하는 임의의 객체로부터 생성합니다. 표준 시퀀스 연산과 더불어 제자리 수정도 지원합니다.

classmethod fromhex(string: str) bytearray

16진수 숫자 쌍으로 이루어진 문자열로부터 bytearray를 생성합니다. 숫자 쌍 사이의 공백은 건너뜁니다. 16진수가 아닌 문자가 있으면 ValueError가 발생합니다.

append(val: int) None

단일 값(0-255 범위의 정수)을 bytearray의 끝에 추가하여 1바이트만큼 늘립니다.

center(width: int, fillbyte: bytes) bytes

내용을 길이 width의 시퀀스 가운데에 배치한 복사본을 반환하며, fillbyte로 채웁니다. CPython과 달리 fillbyte는 필수입니다. width가 현재 길이보다 크지 않으면 데이터가 변경되지 않은 채로 반환됩니다.

count(sub: bytes, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 sub가 겹치지 않게 나타나는 횟수를 반환합니다.

endswith(suffix: bytes, start: int = 0, end: int = -1) bool

내용이 suffix로 끝나면 True를 반환합니다. CPython과 달리 suffix는 여러 값의 튜플일 수 없습니다.

extend(iterable: Iterable[int]) None

iterable의 모든 항목을 bytearray의 끝에 추가합니다. CPython에 대한 확장으로, 버퍼 프로토콜을 지원하는 임의의 객체를 사용할 수 있습니다.

find(sub: bytes, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 sub가 발견되는 가장 낮은 인덱스를 반환하거나, 발견되지 않으면 -1을 반환합니다.

format(*args: Any, **kwargs: Any) str

내용을 형식 문자열로 사용하여 문자열 포매팅 연산을 수행하고, 포매팅된 결과를 반환합니다.

hex(sep: str = '') str

각 바이트를 두 자리 16진수 문자열로 반환합니다. 선택적 인자 sep(길이가 1인 문자열)이 주어지면, 연속된 바이트 값 사이에 삽입됩니다.

index(sub: bytes, start: int = 0, end: int = -1) int

find()와 같지만, sub가 발견되지 않으면 ValueError를 발생시킵니다.

isalpha() bool

모든 바이트가 알파벳 ASCII 문자이고 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

isdigit() bool

모든 바이트가 ASCII 10진수 숫자이고 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

islower() bool

대소문자 구분이 있는 모든 바이트가 소문자이고 그러한 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

isspace() bool

모든 바이트가 ASCII 공백이고 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

isupper() bool

대소문자 구분이 있는 모든 바이트가 대문자이고 그러한 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

join(iterable: Iterable[bytes]) bytes

bytearray 내용을 구분자로 사용하여 iterable의 항목들을 연결한 bytes 객체를 반환합니다.

lower() bytes

모든 ASCII 대문자를 소문자로 변환한 내용의 복사본을 반환합니다.

lstrip(chars: bytes | None = None) bytes

선행 바이트를 제거한 복사본을 반환합니다. chars는 제거할 바이트 집합을 지정하며, 생략하거나 None이면 ASCII 공백이 제거됩니다.

partition(sep: bytes) tuple

sep가 처음 나타나는 곳에서 분할하여 (head, sep, tail)을 반환합니다. sep를 찾지 못하면 내용 다음에 두 개의 빈 객체를 반환합니다.

replace(old: bytes, new: bytes, count: int = -1) bytes

모든 oldnew로 치환한 복사본을 반환합니다. count가 주어지면 처음 count개만 치환됩니다.

rfind(sub: bytes, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 sub가 발견되는 가장 높은 인덱스를 반환하거나, 발견되지 않으면 -1을 반환합니다.

rindex(sub: bytes, start: int = 0, end: int = -1) int

rfind()와 같지만, sub가 발견되지 않으면 ValueError를 발생시킵니다.

rpartition(sep: bytes) tuple

sep가 마지막으로 나타나는 곳에서 분할하여 (head, sep, tail)을 반환합니다. sep를 찾지 못하면 두 개의 빈 객체 다음에 내용을 반환합니다.

rsplit(sep: bytes | None = None, maxsplit: int = -1) list

sep가 나타나는 곳에서 여러 조각으로 분할한 리스트를 반환하며, 오른쪽부터 세어 최대 maxsplit번 분할합니다. sepNone이거나 생략되면 연속된 ASCII 공백을 기준으로 분할합니다.

rstrip(chars: bytes | None = None) bytes

후행 바이트를 제거한 복사본을 반환합니다. chars는 제거할 바이트 집합을 지정하며, 생략하거나 None이면 ASCII 공백이 제거됩니다.

split(sep: bytes | None = None, maxsplit: int = -1) list

sep가 나타나는 곳에서 여러 조각으로 분할한 리스트를 반환합니다. sepNone이거나 생략되면 연속된 ASCII 공백을 기준으로 분할하며 선행/후행 공백은 무시됩니다.

splitlines(keepends: bool = False) list

\n, \r, \r\n을 기준으로 줄을 나눈 리스트를 반환합니다. keepends가 참이 아니면 줄바꿈 문자는 제외됩니다.

startswith(prefix: bytes, start: int = 0, end: int = -1) bool

내용이 prefix로 시작하면 True를 반환합니다. CPython과 달리 prefix는 튜플일 수 없으며, end는 허용되지만 무시됩니다.

strip(chars: bytes | None = None) bytes

선행 및 후행 바이트를 제거한 복사본을 반환합니다. chars는 제거할 바이트 집합을 지정하며, 생략하거나 None이면 ASCII 공백이 제거됩니다.

upper() bytes

모든 ASCII 소문자를 대문자로 변환한 내용의 복사본을 반환합니다.

class bytes(source: int | str | Iterable[int] = b'', encoding: str = 'utf-8', errors: str = 'strict')

0-255 범위의 정수로 이루어진 불변 시퀀스입니다. 정수로부터(0으로 채워진 버퍼), 정수의 iterable로부터, encoding을 지정한 문자열로부터, 또는 버퍼 프로토콜을 지원하는 임의의 객체로부터 생성됩니다. bytes 리터럴은 b'...' 구문을 사용합니다.

classmethod fromhex(string: str) bytes

16진수 숫자 쌍으로 이루어진 문자열로부터 bytes 객체를 생성합니다. 숫자 쌍 사이의 공백은 건너뜁니다. 16진수가 아닌 문자가 있으면 ValueError가 발생합니다.

center(width: int, fillbyte: bytes) bytes

길이 width의 시퀀스 가운데에 배치한 복사본을 반환하며, fillbyte(패드 바이트를 지정하는 길이 1의 bytes)로 채웁니다. CPython과 달리 fillbyte는 필수입니다. width가 길이보다 크지 않으면 원본 객체가 변경되지 않은 채로 반환됩니다.

count(sub: bytes, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 sub가 겹치지 않게 나타나는 횟수를 반환합니다.

decode(encoding: str = 'utf-8') str

bytes에서 디코딩된 str을 반환합니다. MicroPython에서 encoding 인자는 허용되지만 사실상 무시되며(bytes는 UTF-8로 재해석됨), 결과는 동일합니다.

endswith(suffix: bytes, start: int = 0, end: int = -1) bool

bytes가 suffix로 끝나면 True를 반환합니다. CPython과 달리 suffix는 시도할 여러 값의 튜플일 수 없습니다.

find(sub: bytes, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 부분 시퀀스 sub가 발견되는 가장 낮은 인덱스를 반환하거나, 발견되지 않으면 -1을 반환합니다.

format(*args: Any, **kwargs: Any) str

bytes를 형식 문자열로 사용하여 문자열 포매팅 연산을 수행하고, 포매팅된 결과를 반환합니다.

hex(sep: str = '') str

각 바이트를 두 자리 16진수 문자열로 반환합니다. 선택적 인자 sep(길이가 1인 문자열)이 주어지면, 연속된 바이트 값 사이에 삽입됩니다.

index(sub: bytes, start: int = 0, end: int = -1) int

find()와 같지만, sub가 발견되지 않으면 ValueError를 발생시킵니다.

isalpha() bool

모든 바이트가 알파벳 ASCII 문자이고 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

isdigit() bool

모든 바이트가 ASCII 10진수 숫자이고 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

islower() bool

대소문자 구분이 있는 모든 바이트가 소문자이고 그러한 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

isspace() bool

모든 바이트가 ASCII 공백이고 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

isupper() bool

대소문자 구분이 있는 모든 바이트가 대문자이고 그러한 바이트가 하나 이상 있으면 True를, 그렇지 않으면 False를 반환합니다.

join(iterable: Iterable[bytes]) bytes

bytes 객체 자체를 구분자로 사용하여 iterable의 항목들을 연결한 bytes 객체를 반환합니다.

lower() bytes

모든 ASCII 대문자를 소문자로 변환한 복사본을 반환합니다.

lstrip(chars: bytes | None = None) bytes

선행 바이트를 제거한 복사본을 반환합니다. chars는 제거할 바이트 집합을 지정하며, 생략하거나 None이면 ASCII 공백이 제거됩니다.

partition(sep: bytes) tuple

sep가 처음 나타나는 곳에서 분할하여 (head, sep, tail)을 반환합니다. sep를 찾지 못하면 bytes 다음에 두 개의 빈 bytes 객체를 반환합니다.

replace(old: bytes, new: bytes, count: int = -1) bytes

모든 oldnew로 치환한 복사본을 반환합니다. count가 주어지면 처음 count개만 치환됩니다.

rfind(sub: bytes, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 sub가 발견되는 가장 높은 인덱스를 반환하거나, 발견되지 않으면 -1을 반환합니다.

rindex(sub: bytes, start: int = 0, end: int = -1) int

rfind()와 같지만, sub가 발견되지 않으면 ValueError를 발생시킵니다.

rpartition(sep: bytes) tuple

sep가 마지막으로 나타나는 곳에서 분할하여 (head, sep, tail)을 반환합니다. sep를 찾지 못하면 두 개의 빈 bytes 객체 다음에 bytes를 반환합니다.

rsplit(sep: bytes | None = None, maxsplit: int = -1) list

sep가 나타나는 곳에서 여러 조각으로 분할한 리스트를 반환하며, 오른쪽부터 세어 최대 maxsplit번 분할합니다. sepNone이거나 생략되면 연속된 ASCII 공백을 기준으로 분할합니다.

rstrip(chars: bytes | None = None) bytes

후행 바이트를 제거한 복사본을 반환합니다. chars는 제거할 바이트 집합을 지정하며, 생략하거나 None이면 ASCII 공백이 제거됩니다.

split(sep: bytes | None = None, maxsplit: int = -1) list

sep가 나타나는 곳에서 여러 조각으로 분할한 리스트를 반환합니다. sepNone이거나 생략되면 연속된 ASCII 공백을 기준으로 분할하며 선행/후행 공백은 무시됩니다.

splitlines(keepends: bool = False) list

\n, \r, \r\n을 기준으로 줄을 나눈 리스트를 반환합니다. keepends가 참이 아니면 줄바꿈 문자는 제외됩니다.

startswith(prefix: bytes, start: int = 0, end: int = -1) bool

bytes가 prefix로 시작하면 True를 반환합니다. CPython과 달리 prefix는 튜플일 수 없으며, end는 허용되지만 무시됩니다.

strip(chars: bytes | None = None) bytes

선행 및 후행 바이트를 제거한 복사본을 반환합니다. chars는 제거할 바이트 집합을 지정하며, 생략하거나 None이면 ASCII 공백이 제거됩니다.

upper() bytes

모든 ASCII 소문자를 대문자로 변환한 복사본을 반환합니다.

callable(obj: Any) bool

obj가 호출 가능해 보이면 True를, 그렇지 않으면 False를 반환합니다.

chr(i: int) str

유니코드 코드 포인트가 정수 i인 단일 문자로 이루어진 문자열을 반환합니다.

classmethod(func: Callable[..., Any]) classmethod

메서드를 클래스 메서드로 변환합니다. 일반적으로 데코레이터로 사용됩니다.

compile(source: str | bytes, filename: str, mode: str) Any

sourceexec() 또는 eval()로 실행할 수 있는 코드 객체로 컴파일합니다. mode"exec", "eval", "single" 중 하나입니다.

class complex(real: float | str = 0, imag: float = 0)

실수부와 허수부로부터, 또는 문자열로부터 복소수를 생성합니다.

delattr(obj, name: str) None

인자 name은 문자열이어야 하며, 이 함수는 obj로 주어진 객체에서 해당 이름의 속성을 삭제합니다.

class dict(*args, **kwargs)

새 딕셔너리를 생성합니다. CPython의 dict와 동등합니다.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) dict

iterable에서 가져온 키들을 가지며, 각 키가 value(기본값은 None)에 매핑된 새 딕셔너리를 생성합니다. 타입에 대해 호출합니다. 예: dict.fromkeys(...).

clear() None

딕셔너리에서 모든 항목을 제거하여 비웁니다. 딕셔너리가 고정(읽기 전용)이면 TypeError를 발생시킵니다.

copy() dict

딕셔너리의 얕은 복사본을 반환합니다. 반환된 객체는 원본과 동일한 타입(dict 또는 OrderedDict)이지만 고정되어 있지 않습니다.

get(key: Any, default: Any = None) Any

key가 딕셔너리에 있으면 해당 값을 반환하고, 그렇지 않으면 default(그 자체의 기본값은 None이므로 KeyError를 절대 발생시키지 않습니다)를 반환합니다. 딕셔너리는 수정되지 않습니다.

items() Any

딕셔너리에 대한 이후의 변경 사항을 반영하는 (key, value) 쌍에 대한 동적 뷰 객체를 반환하며, 이 객체는 반복, len(), in 연산자, 집합 비교 연산자를 지원합니다.

keys() Any

딕셔너리에 대한 이후의 변경 사항을 반영하는 키에 대한 동적 뷰 객체를 반환하며, 이 객체는 반복, len(), in 연산자, 집합 비교 연산자를 지원합니다.

pop(key: Any, default: Any = None) Any

딕셔너리에서 key를 제거하고 그 값을 반환합니다. key가 없으면 default가 주어졌을 경우 이를 반환하고, 그렇지 않으면 KeyError를 발생시킵니다. 딕셔너리가 고정이면 TypeError를 발생시킵니다.

popitem() tuple

임의의 (key, value) 쌍을 2-튜플로 제거하고 반환합니다. 일반 dict의 경우 선택되는 쌍은 정해져 있지 않으며, OrderedDict의 경우 마지막으로 삽입된 쌍이 제거됩니다(LIFO). 딕셔너리가 비어 있으면 KeyError를, 고정이면 TypeError를 발생시킵니다.

setdefault(key: Any, default: Any = None) Any

key가 딕셔너리에 있으면 해당 값을 반환합니다. 그렇지 않으면 key를 값 default(기본값은 None)와 함께 삽입하고 그 값을 반환합니다. 딕셔너리가 고정되어 있으면 TypeError를 발생시킵니다.

update(*args: Any, **kwargs: Any) None

딕셔너리를 제자리에서 갱신합니다. 위치 인자는 최대 하나만 허용됩니다. 즉 다른 딕셔너리이거나, 두 요소로 된 (key, value) 쌍의 iterable입니다(각각 정확히 두 항목을 산출해야 하며 그렇지 않으면 ValueError가 발생). 그런 다음 키워드 인자가 문자열 키 항목으로 추가됩니다. 기존 키는 덮어쓰입니다. 딕셔너리가 고정이면 TypeError를 발생시킵니다.

values() Any

딕셔너리에 대한 이후의 변경 사항을 반영하는 값에 대한 동적 뷰 객체를 반환하며, 이 객체는 반복과 len()을 지원합니다.

__getitem__(key: Any) Any

self[key]를 반환합니다. 인덱싱 연산자 d[key]를 구현하며, key가 없으면 KeyError를 발생시킵니다.

__setitem__(key: Any, value: Any) None

self[key]value로 설정합니다. d[key] = value를 구현합니다.

__delitem__(key: Any) None

self[key]를 삭제합니다. del d[key]를 구현하며, key가 없으면 KeyError를 발생시킵니다.

dir(obj: Any = None) list

인자가 없으면 현재 지역 범위의 이름 리스트를 반환합니다. 인자가 있으면 해당 객체에 대한 유효한 속성 리스트를 반환합니다.

divmod(a: Any, b: Any) tuple

두 개의 (복소수가 아닌) 숫자에 대해 (a // b, a % b) 쌍을 튜플로 반환합니다.

enumerate(iterable: Iterable[Any], start: int = 0) Iterator[tuple]

iterable로부터 (index, value) 쌍을 산출하는 enumerate 객체를 반환하며, 인덱스는 start부터 시작합니다.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) Any

문자열(또는 컴파일된 코드 객체)로 주어진 Python 표현식을 평가하고 결과를 반환합니다.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) None

문자열 또는 컴파일된 코드 객체로 제공된 Python 코드를 동적으로 실행합니다.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) Iterator[Any]

function이 참을 반환하는 iterable의 요소들로 이터레이터를 생성합니다. functionNone이면 항등 함수가 사용됩니다.

class float(x: str | bytes | int | float = 0.0)

숫자 또는 문자열 x로부터 생성된 부동 소수점 수를 반환합니다.

class frozenset(iterable: Iterable[Any] = ())

선택적으로 iterable에서 가져온 요소로 채워진 새 frozenset 객체를 반환합니다. frozensetset의 불변이고 해시 가능한 변형입니다.

copy() frozenset

frozenset의 얕은 복사본을 반환합니다.

difference(*others: Iterable[Any]) frozenset

frozenset의 요소 중 others의 어디에도 없는 요소들로 이루어진 새 frozenset을 반환합니다. 각 인자는 임의의 iterable일 수 있습니다.

intersection(other: Iterable[Any]) frozenset

frozenset과 other에 공통인 요소들로 이루어진 새 frozenset을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다(CPython은 여러 개를 허용).

isdisjoint(other: Iterable[Any]) bool

frozenset이 other와 공통 요소가 없으면 True를 반환합니다.

issubset(other: Iterable[Any]) bool

frozenset의 모든 요소가 other에 있으면 True를 반환합니다.

issuperset(other: Iterable[Any]) bool

other의 모든 요소가 frozenset에 있으면 True를 반환합니다.

symmetric_difference(other: Iterable[Any]) frozenset

frozenset 또는 other 중 하나에만 있고 양쪽 모두에는 없는 요소들로 이루어진 새 frozenset을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다.

union(other: Iterable[Any]) frozenset

frozenset과 other의 요소들로 이루어진 새 frozenset을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다(CPython은 여러 개를 허용).

getattr(obj: Any, name: str, default: Any = None) Any

obj의 지정된 속성 값을 반환합니다. 속성이 존재하지 않으면 default가 제공된 경우 이를 반환하고, 그렇지 않으면 AttributeError를 발생시킵니다.

globals() dict

현재 모듈의 전역 심볼 테이블을 나타내는 딕셔너리를 반환합니다.

hasattr(obj: Any, name: str) bool

obj가 주어진 name의 속성을 가지면 True를, 그렇지 않으면 False를 반환합니다.

hash(obj: Any) int

obj의 해시 값(있는 경우)을 반환합니다. 해시 값은 딕셔너리 조회 시 딕셔너리 키를 빠르게 비교하는 데 사용되는 정수입니다.

hex(x: int) str

정수를 "0x"로 시작하는 소문자 16진수 문자열로 변환합니다.

id(obj: Any) int

객체의 식별값을 반환합니다. 이는 해당 객체의 수명 동안 고유하고 일정함이 보장되는 정수입니다.

input(prompt: str = '') str

표준 입력에서 한 줄을 읽어 문자열로 반환합니다(후행 줄바꿈 제외). prompt가 주어지면 먼저 후행 줄바꿈 없이 표준 출력에 기록됩니다.

class int(x: str | bytes | int | float = 0, base: int = 10)
classmethod from_bytes(bytes: bytes, byteorder: str) int

MicroPython에서 byteorder 매개변수는 위치 인자여야 합니다(이는 CPython과 호환됩니다).

to_bytes(size: int, byteorder: str) bytes

MicroPython에서 byteorder 매개변수는 위치 인자여야 합니다(이는 CPython과 호환됩니다).

참고

CPython의 선택적 signed 키워드 인자는 지원되지 않습니다. MicroPython은 현재 음의 정수는 부호 있는 형식으로, 양의 정수는 부호 없는 형식으로 변환합니다. (자세한 내용.)

isinstance(obj: Any, classinfo: type | tuple) bool

objclassinfo 또는 그 서브클래스 중 하나의 인스턴스이면 True를 반환합니다. classinfo는 클래스이거나 클래스의 튜플일 수 있습니다.

issubclass(cls: type, classinfo: type | tuple) bool

clsclassinfo의 서브클래스(직접, 간접, 또는 가상)이면 True를 반환합니다.

iter(obj: Any, sentinel: Any = None) Iterator[Any]

이터레이터 객체를 반환합니다. 인자가 하나면 obj는 반복 프로토콜을 지원해야 합니다. 인자가 두 개면 obj는 호출 가능해야 하며, sentinel을 반환할 때 반복이 멈춥니다.

len(obj: Any) int

컨테이너의 항목 수를 반환합니다.

class list(iterable: Iterable[Any] = ())

선택적으로 iterable의 항목들로 채워진 새 리스트를 만듭니다.

append(object: Any) None

object를 리스트의 끝에 추가합니다.

clear() None

리스트에서 모든 항목을 제거하여 비웁니다.

copy() list

리스트의 얕은 복사본을 반환합니다.

count(value: Any) int

리스트에서 value와 같은 요소의 개수를 반환합니다.

extend(iterable: Iterable[Any]) None

iterable의 모든 항목을 리스트의 끝에 추가합니다. iterable 자체가 리스트이면 그 항목들이 직접 복사되고, 그렇지 않으면 반복하여 추가합니다.

index(value: Any, start: int = 0, stop: int = -1) int

슬라이스 [start:stop]을 검색하여 value와 같은 첫 번째 요소의 인덱스를 반환합니다. value가 없으면 ValueError를 발생시킵니다.

insert(index: int, object: Any) None

object를 위치 index 앞에 삽입합니다. 음수 index는 리스트의 끝을 기준으로 해석되며, 인덱스는 유효 범위로 한정됩니다(따라서 양쪽 끝을 넘어가는 값은 처음이나 끝에 삽입됨).

pop(index: int = -1) Any

index(기본값은 마지막 항목)의 항목을 제거하고 반환합니다. 리스트가 비어 있거나 index가 범위를 벗어나면 IndexError를 발생시킵니다.

remove(value: Any) None

value와 같은 첫 번째 요소를 제거합니다. value가 없으면 ValueError를 발생시킵니다.

reverse() None

리스트의 항목을 제자리에서 역순으로 만듭니다.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) None

리스트의 항목을 제자리에서 정렬합니다. keyreverse는 키워드 전용입니다. key가 주어지면 비교 값을 생성하기 위해 각 요소에 적용되는 함수이며, reverse는 내림차순으로 정렬합니다.

참고

CPython과 달리 MicroPython의 리스트 정렬은 안정적이지 않습니다.

locals() dict

현재 지역 심볼 테이블을 나타내는 딕셔너리를 반환합니다.

map(function: Callable[..., Any], *iterables: Iterable[Any]) Iterator[Any]

iterables의 모든 항목에 function을 적용하여 그 결과를 산출하는 이터레이터를 반환합니다.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) Any

단일 iterable 인자가 주어지면 그중 가장 큰 항목을 반환합니다. 두 개 이상의 인자가 주어지면 가장 큰 인자를 반환합니다.

class memoryview(obj: Any)

버퍼 프로토콜을 지원해야 하는 obj(예: bytes, bytearray, array.array)를 참조하는 memoryview를 생성합니다. 기반 메모리에 대한 무복사(zero-copy) 접근과 슬라이싱을 허용하며, memoryview를 슬라이싱하면 복사본이 아닌 또 다른 memoryview를 반환합니다.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) Any

단일 iterable 인자가 주어지면 그중 가장 작은 항목을 반환합니다. 두 개 이상의 인자가 주어지면 가장 작은 인자를 반환합니다.

next(iterator: Iterator[Any], default: Any = None) Any

iterator에서 다음 항목을 가져옵니다. default가 주어지고 이터레이터가 소진되면, StopIteration을 발생시키는 대신 default가 반환됩니다.

class object

특징이 없는 새 객체를 반환합니다. object는 모든 클래스의 기본 클래스입니다.

oct(x: int) str

정수를 "0o"로 시작하는 8진수 문자열로 변환합니다.

open(file: str, mode: str = 'r', **kwargs) Any

file을 열고 해당하는 파일 객체를 반환합니다. mode의 기본값은 텍스트 읽기를 위한 "r"입니다.

ord(c: str) int

단일 문자 문자열 c의 유니코드 코드 포인트를 정수로 반환합니다.

pow(base: Any, exp: Any, mod: Any | None = None) Any

baseexp만큼 거듭제곱한 값을 반환합니다. mod가 주어지면 base ** exp % mod(명시적인 형태보다 더 효율적으로 계산됨)를 반환합니다.

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) None

objects를 텍스트 스트림 file에 출력하며, sep로 구분하고 끝에 end를 붙입니다.

property(fget: Callable[[Any], Any] | None = None, fset: Callable[[Any, Any], None] | None = None, fdel: Callable[[Any], None] | None = None, doc: str | None = None) property

property 속성을 반환합니다. 일반적으로 클래스에 관리되는 속성을 정의하기 위해 데코레이터로 사용됩니다.

range(*args: int) range

정수의 불변 시퀀스를 반환합니다. range(stop), range(start, stop), range(start, stop, step) 형태로 호출됩니다.

repr(obj: Any) str

obj의 출력 가능한 표현을 담은 문자열을 반환합니다.

reversed(seq: Any) Iterator[Any]

주어진 시퀀스의 값에 대한 역방향 이터레이터를 반환합니다.

round(number: Any, ndigits: int | None = None) Any

number를 소수점 아래 ndigits 자리로 반올림하여 반환합니다. ndigits가 생략되면 가장 가까운 정수를 반환합니다.

class set(iterable: Iterable[Any] = ())

선택적으로 iterable에서 가져온 요소로 채워진 새 set 객체를 반환합니다.

add(elem: Any) None

요소 elem을 set에 추가합니다.

clear() None

set에서 모든 요소를 제거합니다.

copy() set

set의 얕은 복사본을 반환합니다.

difference(*others: Iterable[Any]) set

set의 요소 중 others의 어디에도 없는 요소들로 이루어진 새 set을 반환합니다. 각 인자는 임의의 iterable일 수 있습니다.

difference_update(*others: Iterable[Any]) None

others 중 어느 하나에라도 있는 모든 요소를 set에서 제거합니다(제자리).

discard(elem: Any) None

요소 elem이 set에 있으면 제거합니다. remove()와 달리 elem이 없어도 오류를 발생시키지 않습니다.

intersection(other: Iterable[Any]) set

set과 other에 공통인 요소들로 이루어진 새 set을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다(CPython은 여러 개를 허용).

intersection_update(other: Iterable[Any]) None

set을 갱신하여 other에도 있는 요소만 유지합니다(제자리). MicroPython에서는 단일 other 인자만 허용됩니다.

isdisjoint(other: Iterable[Any]) bool

set이 other와 공통 요소가 없으면 True를 반환합니다.

issubset(other: Iterable[Any]) bool

set의 모든 요소가 other에 있으면 True를 반환합니다.

issuperset(other: Iterable[Any]) bool

other의 모든 요소가 set에 있으면 True를 반환합니다.

pop() Any

set에서 임의의 요소를 제거하고 반환합니다. set이 비어 있으면 KeyError를 발생시킵니다.

remove(elem: Any) None

요소 elem을 set에서 제거합니다. elem이 set에 포함되어 있지 않으면 KeyError를 발생시킵니다.

symmetric_difference(other: Iterable[Any]) set

set 또는 other 중 하나에만 있고 양쪽 모두에는 없는 요소들로 이루어진 새 set을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다.

symmetric_difference_update(other: Iterable[Any]) None

set을 갱신하여 set 또는 other 중 하나에만 있는 요소만 유지합니다(제자리). MicroPython에서는 단일 other 인자만 허용됩니다.

union(other: Iterable[Any]) set

set과 other의 요소들로 이루어진 새 set을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다(CPython은 여러 개를 허용).

update(*others: Iterable[Any]) None

others 전체의 요소들을 추가하여 set을 갱신합니다(제자리).

setattr(obj: Any, name: str, value: Any) None

obj의 지정된 속성을 value로 설정합니다. getattr()의 대응 함수입니다.

class slice

slice 내장은 slice 객체가 갖는 타입입니다.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) list

iterable의 항목들로부터 새로 정렬된 리스트를 반환합니다.

staticmethod(func: Callable[..., Any]) staticmethod

메서드를 정적 메서드로 변환합니다. 일반적으로 데코레이터로 사용됩니다.

class str(object: Any = '', encoding: str = 'utf-8', errors: str = 'strict')

object의 문자열 버전을 반환합니다. object가 bytes 유사 객체이면 encodingerrors 인자가 디코딩을 제어합니다.

center(width: int) str

문자열을 길이 width의 필드 가운데에 배치하고 공백으로 채운 복사본을 반환합니다. MicroPython에서는 채우기 문자로 공백만 사용되며(채우기 문자 인자가 없음), width가 길이보다 크지 않으면 원본 문자열이 변경되지 않은 채로 반환됩니다.

count(sub: str, start: int = 0, end: int = -1) int

슬라이스 [start:end] 내에서 sub가 겹치지 않게 나타나는 횟수를 반환합니다. 빈 sub는 문자 사이의 각 간격을 셉니다.

encode(encoding: str = 'utf-8', errors: str = 'strict') bytes

문자열을 인코딩한 bytes 객체를 반환합니다. MicroPython은 사실상 인자를 무시하고 UTF-8을 사용하며, errors는 허용되지만 적용되지 않습니다. bytes(s, "utf-8")와 동등합니다.

endswith(suffix: str | tuple, start: int = 0, end: int = -1) bool

문자열이 주어진 suffix로 끝나면 True를 반환하며, suffix는 단일 문자열이거나 시도할 문자열들의 튜플일 수 있습니다. 선택적 startend는 비교를 슬라이스 [start:end]로 제한합니다.

find(sub: str, start: int = 0, end: int = -1) int

문자열에서 슬라이스 [start:end] 내에 부분 문자열 sub가 발견되는 가장 낮은 인덱스를 반환하거나, 발견되지 않으면 -1을 반환합니다.

format(*args: Any, **kwargs: Any) str

중괄호 {}로 구분된 치환 필드를 argskwargs의 값으로 대체하는 문자열 포매팅 연산을 수행합니다. 표준 형식 명세 미니 언어를 지원합니다.

index(sub: str, start: int = 0, end: int = -1) int

find()와 같지만, 슬라이스 [start:end] 내에서 부분 문자열 sub가 발견되지 않으면 ValueError를 발생시킵니다.

isalpha() bool

문자열의 모든 문자가 알파벳이고 문자열이 비어 있지 않으면 True를, 그렇지 않으면 False를 반환합니다.

isdigit() bool

문자열의 모든 문자가 숫자이고 문자열이 비어 있지 않으면 True를, 그렇지 않으면 False를 반환합니다.

islower() bool

문자열에 알파벳 문자가 하나 이상 있고 그러한 모든 문자가 소문자이면 True를, 그렇지 않으면 False를 반환합니다.

isspace() bool

문자열의 모든 문자가 공백이고 문자열이 비어 있지 않으면 True를, 그렇지 않으면 False를 반환합니다.

isupper() bool

문자열에 알파벳 문자가 하나 이상 있고 그러한 모든 문자가 대문자이면 True를, 그렇지 않으면 False를 반환합니다.

join(iterable: Iterable[str]) str

iterable의 문자열들을 연결하며, 요소 사이에 이 문자열을 구분자로 삽입합니다. 항목은 문자열이어야 하며, 그렇지 않으면 TypeError가 발생합니다.

lower() str

모든 문자를 소문자로 변환한 문자열의 복사본을 반환합니다.

lstrip(chars: str | None = None) str

선행 문자를 제거한 문자열의 복사본을 반환합니다. chars가 생략되거나 None이면 공백이 제거되고, 그렇지 않으면 chars는 제거할 문자 집합으로 취급됩니다.

partition(sep: str) tuple

sep가 처음 나타나는 곳에서 문자열을 분할하여 3-튜플 (head, sep, tail)을 반환합니다. sep를 찾지 못하면 (self, "", "")을 반환합니다. 빈 sepValueError를 발생시킵니다.

replace(old: str, new: str, count: int = -1) str

부분 문자열 old를 모두 new로 치환한 문자열의 복사본을 반환합니다. count가 주어지고 음수가 아니면 처음 count개만 치환됩니다.

rfind(sub: str, start: int = 0, end: int = -1) int

문자열에서 슬라이스 [start:end] 내에 부분 문자열 sub가 발견되는 가장 높은 인덱스를 반환하거나, 발견되지 않으면 -1을 반환합니다.

rindex(sub: str, start: int = 0, end: int = -1) int

rfind()와 같지만, 슬라이스 [start:end] 내에서 부분 문자열 sub가 발견되지 않으면 ValueError를 발생시킵니다.

rpartition(sep: str) tuple

sep가 마지막으로 나타나는 곳에서 문자열을 분할하여 3-튜플 (head, sep, tail)을 반환합니다. sep를 찾지 못하면 ("", "", self)를 반환합니다. 빈 sepValueError를 발생시킵니다.

rsplit(sep: str | None = None, maxsplit: int = -1) list

sep를 구분자로 사용하여 문자열을 오른쪽부터 부분 문자열 리스트로 분할하며, 최대 maxsplit번 분할합니다. maxsplit가 없으면(또는 음수이면) split()과 동일하게 동작합니다. MicroPython에서 음수가 아닌 n으로 rsplit(None, n)을 호출하면 NotImplementedError를 발생시킵니다.

rstrip(chars: str | None = None) str

후행 문자를 제거한 문자열의 복사본을 반환합니다. chars가 생략되거나 None이면 공백이 제거되고, 그렇지 않으면 chars는 제거할 문자 집합으로 취급됩니다.

split(sep: str | None = None, maxsplit: int = -1) list

sep를 구분자로 사용하여 문자열을 부분 문자열 리스트로 분할하며, 최대 maxsplit번 분할합니다. sep가 생략되거나 None이면 연속된 공백을 기준으로 분할하고 선행 공백은 무시되며, 그렇지 않으면 빈 sepValueError를 발생시킵니다.

splitlines(keepends: bool = False) list

문자열에서 \n, \r, \r\n을 기준으로 줄을 나눈 리스트를 반환합니다. keepends가 참이 아니면 줄바꿈 문자는 포함되지 않습니다.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) bool

문자열이 주어진 prefix로 시작하면 True를 반환하며, prefix는 단일 문자열이거나 시도할 문자열들의 튜플일 수 있습니다. 선택적 startend는 비교를 슬라이스 [start:end]로 제한합니다.

strip(chars: str | None = None) str

선행 및 후행 문자를 제거한 문자열의 복사본을 반환합니다. chars가 생략되거나 None이면 공백이 제거되고, 그렇지 않으면 chars는 제거할 문자 집합으로 취급됩니다.

upper() str

모든 문자를 대문자로 변환한 문자열의 복사본을 반환합니다.

sum(iterable: Iterable[Any], start: Any = 0) Any

startiterable의 항목들을 왼쪽에서 오른쪽으로 더하여 합계를 반환합니다.

super(type: type | None = None, obj_or_type: Any | None = None) Any

type의 부모 또는 형제 클래스에 메서드 호출을 위임하는 프록시 객체를 반환합니다. 클래스에서 재정의된 상속 메서드에 접근할 때 유용합니다.

class tuple(iterable: Iterable[Any] = ())

선택적으로 iterable의 항목들로 채워진 새 튜플을 만듭니다. 튜플은 불변 시퀀스입니다.

count(value: Any) int

튜플에서 value와 같은 요소의 개수를 반환합니다.

index(value: Any, start: int = 0, stop: int = -1) int

슬라이스 [start:stop]을 검색하여 value와 같은 첫 번째 요소의 인덱스를 반환합니다. value가 없으면 ValueError를 발생시킵니다.

type(obj: Any) type

인자가 하나면 obj의 타입을 반환합니다. 반환되는 값은 타입 객체입니다.

zip(*iterables: Iterable[Any]) Iterator[tuple]

튜플의 이터레이터를 반환하며, i번째 튜플은 각 인자 iterable의 i번째 요소를 담습니다. 가장 짧은 입력 iterable이 소진되면 반복이 멈춥니다.

예외

exception AssertionError

assert 문이 실패할 때 발생합니다.

exception AttributeError

속성 참조나 할당이 실패할 때 발생합니다.

exception Exception

시스템을 종료하지 않는 모든 예외의 공통 기본 클래스입니다.

exception ImportError

import 문이 모듈 정의를 찾지 못할 때 발생합니다.

exception IndexError

시퀀스의 첨자가 범위를 벗어날 때 발생합니다.

exception KeyboardInterrupt

사용자가 보통 REPL에서 Ctrl+C를 눌러 프로그램 실행을 중단할 때 발생합니다.

소프트 브릭(부팅 실패)의 맥락에서도 참조하십시오.

exception KeyError

매핑(딕셔너리) 키가 기존 키 집합에서 발견되지 않을 때 발생합니다.

exception MemoryError

연산이 메모리를 모두 소진할 때 발생합니다.

exception NameError

지역 또는 전역 이름을 찾지 못할 때 발생합니다.

exception NotImplementedError

추상 메서드나 구현되지 않은 기능이 호출될 때 발생합니다.

exception OSError

시스템 함수가 시스템 관련 오류를 반환할 때 발생합니다.

exception RuntimeError

다른 어떤 범주에도 속하지 않는 오류가 감지될 때 발생합니다.

exception StopIteration

next()와 이터레이터의 __next__() 메서드가 더 이상 항목이 없음을 알리기 위해 발생시킵니다.

exception SyntaxError

파서가 구문 오류를 만날 때 발생합니다.

exception SystemExit

sys.exit()가 인터프리터 종료를 요청하기 위해 발생시킵니다. 대부분의 예외와 달리, 처리되지 않은 채로 두어도 트레이스백을 생성하지 않습니다.

OpenMV Cam에서는 처리되지 않은 SystemExit가 현재 MicroPython의 소프트 리셋을 유발합니다.

exception TypeError

부적절한 타입의 객체에 연산이나 함수가 적용될 때 발생합니다.

exception ValueError

내장 연산이나 함수가 올바른 타입이지만 부적절한 값의 인자를 받을 때 발생합니다.

exception ZeroDivisionError

나눗셈 또는 모듈로 연산의 두 번째 인자가 0일 때 발생합니다.