`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#: 모든 old를 new로 치환한 복사본을 반환합니다. 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번 분할합니다. sep가 None이거나 생략되면 연속된 ASCII 공백을 기준으로 분할합니다.

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

split(sep: bytes | None = None, maxsplit: int = -1) → list#: sep가 나타나는 곳에서 여러 조각으로 분할한 리스트를 반환합니다. sep가 None이거나 생략되면 연속된 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#: 모든 old를 new로 치환한 복사본을 반환합니다. 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번 분할합니다. sep가 None이거나 생략되면 연속된 ASCII 공백을 기준으로 분할합니다.

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

split(sep: bytes | None = None, maxsplit: int = -1) → list#: sep가 나타나는 곳에서 여러 조각으로 분할한 리스트를 반환합니다. sep가 None이거나 생략되면 연속된 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#: source를 exec() 또는 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의 요소들로 이터레이터를 생성합니다. function이 None이면 항등 함수가 사용됩니다.

class float(x: str | bytes | int | float = 0.0)#: 숫자 또는 문자열 x로부터 생성된 부동 소수점 수를 반환합니다.

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

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

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#: obj가 classinfo 또는 그 서브클래스 중 하나의 인스턴스이면 True를 반환합니다. classinfo는 클래스이거나 클래스의 튜플일 수 있습니다.

issubclass(cls: type, classinfo: type | tuple) → bool#: cls가 classinfo의 서브클래스(직접, 간접, 또는 가상)이면 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#: 리스트의 항목을 제자리에서 정렬합니다. key와 reverse는 키워드 전용입니다. 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#: base를 exp만큼 거듭제곱한 값을 반환합니다. 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 유사 객체이면 encoding과 errors 인자가 디코딩을 제어합니다.

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는 단일 문자열이거나 시도할 문자열들의 튜플일 수 있습니다. 선택적 start와 end는 비교를 슬라이스 [start:end]로 제한합니다.

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

format(*args: Any, **kwargs: Any) → str#: 중괄호 {}로 구분된 치환 필드를 args와 kwargs의 값으로 대체하는 문자열 포매팅 연산을 수행합니다. 표준 형식 명세 미니 언어를 지원합니다.

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, "", "")을 반환합니다. 빈 sep는 ValueError를 발생시킵니다.

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)를 반환합니다. 빈 sep는 ValueError를 발생시킵니다.

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이면 연속된 공백을 기준으로 분할하고 선행 공백은 무시되며, 그렇지 않으면 빈 sep는 ValueError를 발생시킵니다.

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

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool#: 문자열이 주어진 prefix로 시작하면 True를 반환하며, prefix는 단일 문자열이거나 시도할 문자열들의 튜플일 수 있습니다. 선택적 start와 end는 비교를 슬라이스 [start:end]로 제한합니다.

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

upper() → str#: 모든 문자를 대문자로 변환한 문자열의 복사본을 반환합니다.

sum(iterable: Iterable[Any], start: Any = 0) → Any#: start와 iterable의 항목들을 왼쪽에서 오른쪽으로 더하여 합계를 반환합니다.

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일 때 발생합니다.

builtins — 내장 함수 및 예외#

함수 및 타입#

예외#

`builtins` — 내장 함수 및 예외#