builtins — 내장 함수 및 예외¶
모든 내장 함수와 예외가 여기에 설명되어 있습니다. 이들은 builtins 모듈을 통해서도 사용할 수 있습니다.
함수 및 타입¶
- abs(x: Any) Any¶
숫자의 절댓값을 반환합니다. 인자는 정수, 부동 소수점 수, 또는
__abs__()를 구현한 임의의 객체일 수 있습니다.
- any(iterable: Iterable[Any]) bool¶
iterable의 요소 중 하나라도 참이면
True를 반환합니다. iterable이 비어 있으면False를 반환합니다.
- 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가 발생합니다.
- 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을 반환합니다.
- hex(sep: str = '') str¶
각 바이트를 두 자리 16진수 문자열로 반환합니다. 선택적 인자 sep(길이가 1인 문자열)이 주어지면, 연속된 바이트 값 사이에 삽입됩니다.
- index(sub: bytes, start: int = 0, end: int = -1) int¶
find()와 같지만, sub가 발견되지 않으면ValueError를 발생시킵니다.
- 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는 허용되지만 무시됩니다.
- 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을 반환합니다.
- hex(sep: str = '') str¶
각 바이트를 두 자리 16진수 문자열로 반환합니다. 선택적 인자 sep(길이가 1인 문자열)이 주어지면, 연속된 바이트 값 사이에 삽입됩니다.
- index(sub: bytes, start: int = 0, end: int = -1) int¶
find()와 같지만, sub가 발견되지 않으면ValueError를 발생시킵니다.
- 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는 허용되지만 무시됩니다.
- classmethod(func: Callable[..., Any]) classmethod¶
메서드를 클래스 메서드로 변환합니다. 일반적으로 데코레이터로 사용됩니다.
- compile(source: str | bytes, filename: str, mode: str) Any¶
source를
exec()또는eval()로 실행할 수 있는 코드 객체로 컴파일합니다. mode는"exec","eval","single"중 하나입니다.
- class dict(*args, **kwargs)¶
새 딕셔너리를 생성합니다. CPython의
dict와 동등합니다.- classmethod fromkeys(iterable: Iterable[Any], value: Any = None) dict¶
iterable에서 가져온 키들을 가지며, 각 키가 value(기본값은
None)에 매핑된 새 딕셔너리를 생성합니다. 타입에 대해 호출합니다. 예:dict.fromkeys(...).
- 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를 발생시킵니다.
- 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 frozenset(iterable: Iterable[Any] = ())¶
선택적으로 iterable에서 가져온 요소로 채워진 새 frozenset 객체를 반환합니다.
frozenset은set의 불변이고 해시 가능한 변형입니다.- difference(*others: Iterable[Any]) frozenset¶
frozenset의 요소 중 others의 어디에도 없는 요소들로 이루어진 새 frozenset을 반환합니다. 각 인자는 임의의 iterable일 수 있습니다.
- intersection(other: Iterable[Any]) frozenset¶
frozenset과 other에 공통인 요소들로 이루어진 새 frozenset을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다(CPython은 여러 개를 허용).
- getattr(obj: Any, name: str, default: Any = None) Any¶
obj의 지정된 속성 값을 반환합니다. 속성이 존재하지 않으면 default가 제공된 경우 이를 반환하고, 그렇지 않으면
AttributeError를 발생시킵니다.
- input(prompt: str = '') str¶
표준 입력에서 한 줄을 읽어 문자열로 반환합니다(후행 줄바꿈 제외). prompt가 주어지면 먼저 후행 줄바꿈 없이 표준 출력에 기록됩니다.
- class int(x: str | bytes | int | float = 0, base: int = 10)¶
- 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을 반환할 때 반복이 멈춥니다.
- class list(iterable: Iterable[Any] = ())¶
선택적으로 iterable의 항목들로 채워진 새 리스트를 만듭니다.
- 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를 발생시킵니다.
- 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는 모든 클래스의 기본 클래스입니다.
- open(file: str, mode: str = 'r', **kwargs) Any¶
file을 열고 해당하는 파일 객체를 반환합니다. mode의 기본값은 텍스트 읽기를 위한
"r"입니다.
- 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)형태로 호출됩니다.
- reversed(seq: Any) Iterator[Any]¶
주어진 시퀀스의 값에 대한 역방향 이터레이터를 반환합니다.
- round(number: Any, ndigits: int | None = None) Any¶
number를 소수점 아래 ndigits 자리로 반올림하여 반환합니다. ndigits가 생략되면 가장 가까운 정수를 반환합니다.
- class set(iterable: Iterable[Any] = ())¶
선택적으로 iterable에서 가져온 요소로 채워진 새 set 객체를 반환합니다.
- difference(*others: Iterable[Any]) set¶
set의 요소 중 others의 어디에도 없는 요소들로 이루어진 새 set을 반환합니다. 각 인자는 임의의 iterable일 수 있습니다.
- intersection(other: Iterable[Any]) set¶
set과 other에 공통인 요소들로 이루어진 새 set을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다(CPython은 여러 개를 허용).
- intersection_update(other: Iterable[Any]) None¶
set을 갱신하여 other에도 있는 요소만 유지합니다(제자리). MicroPython에서는 단일 other 인자만 허용됩니다.
- symmetric_difference(other: Iterable[Any]) set¶
set 또는 other 중 하나에만 있고 양쪽 모두에는 없는 요소들로 이루어진 새 set을 반환합니다. MicroPython에서는 단일 other 인자만 허용됩니다.
- symmetric_difference_update(other: Iterable[Any]) None¶
set을 갱신하여 set 또는 other 중 하나에만 있는 요소만 유지합니다(제자리). MicroPython에서는 단일 other 인자만 허용됩니다.
- 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를 발생시킵니다.
- join(iterable: Iterable[str]) str¶
iterable의 문자열들을 연결하며, 요소 사이에 이 문자열을 구분자로 삽입합니다. 항목은 문자열이어야 하며, 그렇지 않으면
TypeError가 발생합니다.
- 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]로 제한합니다.
- sum(iterable: Iterable[Any], start: Any = 0) Any¶
start와 iterable의 항목들을 왼쪽에서 오른쪽으로 더하여 합계를 반환합니다.
- super(type: type | None = None, obj_or_type: Any | None = None) Any¶
type의 부모 또는 형제 클래스에 메서드 호출을 위임하는 프록시 객체를 반환합니다. 클래스에서 재정의된 상속 메서드에 접근할 때 유용합니다.
예외¶
- 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 SyntaxError¶
파서가 구문 오류를 만날 때 발생합니다.
- exception SystemExit¶
sys.exit()가 인터프리터 종료를 요청하기 위해 발생시킵니다. 대부분의 예외와 달리, 처리되지 않은 채로 두어도 트레이스백을 생성하지 않습니다.OpenMV Cam에서는 처리되지 않은
SystemExit가 현재 MicroPython의 소프트 리셋을 유발합니다.
- exception TypeError¶
부적절한 타입의 객체에 연산이나 함수가 적용될 때 발생합니다.
- exception ValueError¶
내장 연산이나 함수가 올바른 타입이지만 부적절한 값의 인자를 받을 때 발생합니다.
- exception ZeroDivisionError¶
나눗셈 또는 모듈로 연산의 두 번째 인자가 0일 때 발생합니다.