builtins — встроенные функции и исключения

Здесь описаны все встроенные функции и исключения. Они также доступны через модуль builtins.

Функции и типы

abs(x: Any) → Any

Возвращает абсолютное значение числа. Аргумент может быть целым числом, числом с плавающей точкой или любым объектом, реализующим __abs__().

all(iterable: Iterable[Any]) → bool

Возвращает True, если все элементы iterable истинны (или если итерируемый объект пуст).

any(iterable: Iterable[Any]) → bool

Возвращает True, если хотя бы один элемент iterable истинен. Возвращает False, если итерируемый объект пуст.

bin(x: int) → str

Преобразует целое число в двоичную строку с префиксом "0b". Аргумент должен быть целым числом 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: из целого числа (создаётся заполненный нулями буфер этого размера), из итерируемого объекта целых чисел, из строки с encoding или из любого объекта, поддерживающего протокол буфера. Поддерживает стандартные операции с последовательностями, а также изменение на месте.

classmethod fromhex(string: str) → bytearray

Создаёт bytearray из строки пар шестнадцатеричных цифр. Пробельные символы между парами цифр пропускаются; недопустимый шестнадцатеричный символ вызывает ValueError.

append(val: int) → None

Добавляет одно значение (целое число в диапазоне 0-255) в конец bytearray, увеличивая его на один байт.

center(width: int, fillbyte: bytes) → bytes

Возвращает копию содержимого, выровненную по центру в последовательности длины width, дополненную fillbyte. В отличие от CPython, fillbyte обязателен. Данные возвращаются без изменений, если width не превышает текущую длину.

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

Возвращает количество непересекающихся вхождений sub в срезе [start:end].

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

Возвращает True, если содержимое заканчивается на suffix. В отличие от CPython, suffix не может быть кортежем значений.

extend(iterable: Iterable[int]) → None

Добавляет все элементы из iterable в конец bytearray. В качестве расширения CPython может использоваться любой объект, поддерживающий протокол буфера.

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

Возвращает наименьший индекс, по которому sub найдена в срезе [start:end], или -1, если не найдена.

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

Выполняет операцию форматирования строки, используя содержимое в качестве строки формата, и возвращает отформатированный результат.

hex(sep: str = '') → str

Возвращает строку из двух шестнадцатеричных цифр для каждого байта. Если задан необязательный sep (строка длины 1), он вставляется между последовательными значениями байтов.

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

Как find(), но вызывает ValueError, если sub не найдена.

isalpha() → bool

Возвращает True, если все байты являются алфавитными символами ASCII и есть хотя бы один байт, иначе False.

isdigit() → bool

Возвращает True, если все байты являются десятичными цифрами ASCII и есть хотя бы один байт, иначе False.

islower() → bool

Возвращает True, если все байты с регистром являются строчными и есть хотя бы один байт с регистром, иначе False.

isspace() → bool

Возвращает True, если все байты являются пробельными символами ASCII и есть хотя бы один байт, иначе False.

isupper() → bool

Возвращает True, если все байты с регистром являются прописными и есть хотя бы один байт с регистром, иначе False.

join(iterable: Iterable[bytes]) → bytes

Возвращает объект bytes, представляющий собой конкатенацию элементов из iterable, с использованием содержимого bytearray в качестве разделителя.

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

Возвращает наибольший индекс, по которому sub найдена в срезе [start:end], или -1, если не найдена.

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

Как rfind(), но вызывает ValueError, если sub не найдена.

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 не равен true.

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

Возвращает True, если содержимое начинается с prefix. В отличие от 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. Создаётся из целого числа (заполненный нулями буфер), из итерируемого объекта целых чисел, из строки с encoding или из любого объекта, поддерживающего протокол буфера. Байтовые литералы используют синтаксис b'...'.

classmethod fromhex(string: str) → bytes

Создаёт объект bytes из строки пар шестнадцатеричных цифр. Пробельные символы между парами цифр пропускаются; недопустимый шестнадцатеричный символ вызывает ValueError.

center(width: int, fillbyte: bytes) → bytes

Возвращает копию, выровненную по центру в последовательности длины width, дополненную fillbyte (объектом bytes длины 1, задающим байт-заполнитель). В отличие от CPython, fillbyte обязателен. Исходный объект возвращается без изменений, если width не превышает его длину.

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

Возвращает количество непересекающихся вхождений sub в срезе [start:end].

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

Возвращает str, декодированную из байтов. В MicroPython аргумент encoding принимается, но фактически игнорируется (байты переинтерпретируются как UTF-8).

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

Возвращает True, если байты заканчиваются на suffix. В отличие от CPython, suffix не может быть кортежем значений для проверки.

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

Возвращает наименьший индекс, по которому подпоследовательность sub найдена в срезе [start:end], или -1, если не найдена.

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

Выполняет операцию форматирования строки, используя байты в качестве строки формата, и возвращает отформатированный результат.

hex(sep: str = '') → str

Возвращает строку из двух шестнадцатеричных цифр для каждого байта. Если задан необязательный sep (строка длины 1), он вставляется между последовательными значениями байтов.

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

Как find(), но вызывает ValueError, если sub не найдена.

isalpha() → bool

Возвращает True, если все байты являются алфавитными символами ASCII и есть хотя бы один байт, иначе False.

isdigit() → bool

Возвращает True, если все байты являются десятичными цифрами ASCII и есть хотя бы один байт, иначе False.

islower() → bool

Возвращает True, если все байты с регистром являются строчными и есть хотя бы один байт с регистром, иначе False.

isspace() → bool

Возвращает True, если все байты являются пробельными символами ASCII и есть хотя бы один байт, иначе 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.

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

Возвращает копию, в которой все вхождения old заменены на new. Если задан count, заменяются только первые count вхождений.

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

Возвращает наибольший индекс, по которому sub найдена в срезе [start:end], или -1, если не найдена.

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

Как rfind(), но вызывает ValueError, если sub не найдена.

rpartition(sep: bytes) → tuple

Разбивает по последнему вхождению sep, возвращая (head, sep, tail). Если sep не найден, возвращает два пустых объекта 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 не равен true.

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

Возвращает True, если байты начинаются с prefix. В отличие от CPython, prefix не может быть кортежем, а end принимается, но игнорируется.

strip(chars: bytes | None = None) → bytes

Возвращает копию с удалёнными ведущими и завершающими байтами. chars задаёт набор удаляемых байтов; если опущен или равен None, удаляются пробельные символы ASCII.

upper() → bytes

Возвращает копию, в которой все строчные символы ASCII преобразованы в прописные.

callable(obj: Any) → bool

Возвращает True, если obj является вызываемым, иначе False.

chr(i: int) → str

Возвращает строку из одного символа, кодовая точка Unicode которого равна целому числу 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)

Создаёт новый словарь. Эквивалентно dict из CPython.

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) (каждая должна давать ровно два элемента, иначе вызывается ValueError). Затем добавляются именованные аргументы как записи со строковыми ключами. Существующие ключи перезаписываются. Вызывает TypeError, если словарь фиксированный.

values() → Any

Возвращает динамический объект-представление значений, который отражает последующие изменения словаря и поддерживает итерацию и len().

__getitem__(key: Any) → Any

Возвращает self[key]. Реализует оператор индексирования d[key]; вызывает KeyError, если key отсутствует.

__setitem__(key: Any, value: Any) → None

Устанавливает self[key] в value. Реализует d[key] = value.

__delitem__(key: Any) → None

Удаляет self[key]. Реализует del d[key]; вызывает KeyError, если key отсутствует.

dir(obj: Any = None) → list

Без аргументов возвращает список имён в текущей локальной области видимости. С аргументом возвращает список допустимых атрибутов этого объекта.

divmod(a: Any, b: Any) → tuple

Возвращает пару (a // b, a % b) в виде кортежа для двух (не комплексных) чисел.

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

Возвращает объект enumerate, порождающий пары (index, value) из iterable, при этом индекс начинается с 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]

Строит итератор из тех элементов iterable, для которых function возвращает истину. Если function равна None, предполагается тождественная функция.

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

Возвращает число с плавающей точкой, построенное из числа или строки x.

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

Возвращает новый объект frozenset, при необходимости с элементами, взятыми из iterable. frozenset — это неизменяемый, хешируемый вариант set.

copy() → frozenset

Возвращает поверхностную копию frozenset.

difference(*others: Iterable[Any]) → frozenset

Возвращает новый frozenset с элементами из frozenset, которых нет ни в одном из others. Каждый аргумент может быть любым итерируемым объектом.

intersection(other: Iterable[Any]) → frozenset

Возвращает новый frozenset с элементами, общими для frozenset и other. В MicroPython принимается только один аргумент other (CPython принимает несколько).

isdisjoint(other: Iterable[Any]) → bool

Возвращает True, если frozenset не имеет общих элементов с other.

issubset(other: Iterable[Any]) → bool

Возвращает True, если каждый элемент frozenset содержится в other.

issuperset(other: Iterable[Any]) → bool

Возвращает True, если каждый элемент other содержится в frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset

Возвращает новый frozenset с элементами, которые есть либо в frozenset, либо в other, но не в обоих сразу. В MicroPython принимается только один аргумент other.

union(other: Iterable[Any]) → frozenset

Возвращает новый frozenset с элементами из frozenset и other. В MicroPython принимается только один аргумент other (CPython принимает несколько).

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

Возвращает значение именованного атрибута obj. Если атрибут не существует, возвращается default, если он задан, иначе вызывается AttributeError.

globals() → dict

Возвращает словарь, представляющий таблицу глобальных символов текущего модуля.

hasattr(obj: Any, name: str) → bool

Возвращает True, если obj имеет атрибут с заданным name, иначе False.

hash(obj: Any) → int

Возвращает хеш-значение obj (если оно есть). Хеш-значения — это целые числа, используемые для быстрого сравнения ключей словаря при поиске в словаре.

hex(x: int) → str

Преобразует целое число в строчную шестнадцатеричную строку с префиксом "0x".

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).

Примечание

Необязательный именованный аргумент signed из CPython не поддерживается. MicroPython в настоящее время преобразует отрицательные целые числа как знаковые, а положительные — как беззнаковые. (Подробнее.)

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

Возвращает True, если obj является экземпляром classinfo или любого из его подклассов. classinfo может быть классом или кортежем классов.

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

Возвращает True, если cls является подклассом (прямым, косвенным или виртуальным) classinfo.

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

Возвращает индекс первого элемента, равного value, при поиске в срезе [start:stop]. Вызывает ValueError, если value отсутствует.

insert(index: int, object: Any) → None

Вставляет object перед позицией index. Отрицательный index интерпретируется относительно конца списка, и индекс ограничивается допустимым диапазоном (поэтому значения за пределами любого из концов вставляют элемент в начало или конец).

pop(index: int = -1) → Any

Удаляет и возвращает элемент с индексом index (по умолчанию последний элемент). Вызывает IndexError, если список пуст или index выходит за пределы диапазона.

remove(value: Any) → None

Удаляет первый элемент, равный value. Вызывает ValueError, если value отсутствует.

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]

Возвращает итератор, применяющий function к каждому элементу iterables и порождающий результаты.

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

С одним итерируемым аргументом возвращает его наибольший элемент. С двумя или более аргументами возвращает наибольший аргумент.

class memoryview(obj: Any)

Создаёт memoryview, ссылающийся на obj, который должен поддерживать протокол буфера (например, bytes, bytearray, array.array). Позволяет осуществлять доступ к нижележащей памяти и её срезы без копирования; срез memoryview возвращает другой memoryview, а не копию.

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

С одним итерируемым аргументом возвращает его наименьший элемент. С двумя или более аргументами возвращает наименьший аргумент.

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

Извлекает следующий элемент из iterator. Если задан default и итератор исчерпан, вместо вызова StopIteration возвращается default.

class object

Возвращает новый объект без особенностей. object — это базовый класс для всех классов.

oct(x: int) → str

Преобразует целое число в восьмеричную строку с префиксом "0o".

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

Открывает file и возвращает соответствующий файловый объект. mode по умолчанию равен "r" для чтения текста.

ord(c: str) → int

Возвращает кодовую точку Unicode односимвольной строки 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

Возвращает атрибут-свойство. Обычно используется в качестве декоратора для определения управляемых атрибутов класса.

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] = ())

Возвращает новый объект set, при необходимости с элементами, взятыми из iterable.

add(elem: Any) → None

Добавляет элемент elem в множество.

clear() → None

Удаляет все элементы из множества.

copy() → set

Возвращает поверхностную копию множества.

difference(*others: Iterable[Any]) → set

Возвращает новое множество с элементами из множества, которых нет ни в одном из others. Каждый аргумент может быть любым итерируемым объектом.

difference_update(*others: Iterable[Any]) → None

Удаляет из множества все элементы, найденные в любом из others (на месте).

discard(elem: Any) → None

Удаляет элемент elem из множества, если он присутствует. В отличие от remove(), не вызывает ошибку, если elem отсутствует.

intersection(other: Iterable[Any]) → set

Возвращает новое множество с элементами, общими для множества и other. В MicroPython принимается только один аргумент other (CPython принимает несколько).

intersection_update(other: Iterable[Any]) → None

Обновляет множество, оставляя только элементы, которые также есть в other (на месте). В MicroPython принимается только один аргумент other.

isdisjoint(other: Iterable[Any]) → bool

Возвращает True, если множество не имеет общих элементов с other.

issubset(other: Iterable[Any]) → bool

Возвращает True, если каждый элемент множества содержится в other.

issuperset(other: Iterable[Any]) → bool

Возвращает True, если каждый элемент other содержится в множестве.

pop() → Any

Удаляет и возвращает произвольный элемент из множества. Вызывает KeyError, если множество пусто.

remove(elem: Any) → None

Удаляет элемент elem из множества. Вызывает KeyError, если elem не содержится в множестве.

symmetric_difference(other: Iterable[Any]) → set

Возвращает новое множество с элементами, которые есть либо в множестве, либо в other, но не в обоих сразу. В MicroPython принимается только один аргумент other.

symmetric_difference_update(other: Iterable[Any]) → None

Обновляет множество, оставляя только элементы, которые есть либо в множестве, либо в other, но не в обоих сразу (на месте). В MicroPython принимается только один аргумент other.

union(other: Iterable[Any]) → set

Возвращает новое множество с элементами из множества и other. В MicroPython принимается только один аргумент other (CPython принимает несколько).

update(*others: Iterable[Any]) → None

Обновляет множество, добавляя элементы из всех others (на месте).

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

Устанавливает именованный атрибут obj в value. Дополнение к getattr().

class 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 является байтоподобным объектом, аргументы encoding и errors управляют декодированием.

center(width: int) → str

Возвращает копию строки, выровненную по центру в поле длины width, дополненную пробелами. В MicroPython в качестве символа-заполнителя используется только пробел (аргумента символа-заполнителя нет), и исходная строка возвращается без изменений, если width не превышает её длину.

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

Возвращает количество непересекающихся вхождений sub в срезе [start:end]. Пустой 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

Возвращает True, если строка заканчивается заданным suffix, который может быть одной строкой или кортежем строк для проверки. Необязательные start и end ограничивают сравнение срезом [start:end].

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

Возвращает наименьший индекс в строке, по которому подстрока sub найдена в срезе [start:end], или -1, если она не найдена.

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

Выполняет операцию форматирования строки, подставляя поля замены, ограниченные фигурными скобками {}, значениями из args и kwargs. Поддерживает стандартный мини-язык спецификации формата.

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

Как find(), но вызывает ValueError, если подстрока sub не найдена в срезе [start:end].

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

Возвращает наибольший индекс в строке, по которому подстрока sub найдена в срезе [start:end], или -1, если она не найдена.

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

Как rfind(), но вызывает ValueError, если подстрока sub не найдена в срезе [start:end].

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 rsplit(None, n) с неотрицательным 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 не равен true.

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

Возвращает 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

Возвращает индекс первого элемента, равного value, при поиске в срезе [start:stop]. Вызывает ValueError, если value отсутствует.

type(obj: Any) → type

С одним аргументом возвращает тип obj. Возвращаемое значение является объектом-типом.

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

Возвращает итератор кортежей, где i-й кортеж содержит i-й элемент из каждого аргумента-итерируемого объекта. Итерация останавливается, когда исчерпан кратчайший входной итерируемый объект.

Исключения

exception AssertionError

Возникает при неудаче инструкции assert.

exception AttributeError

Возникает при неудаче обращения к атрибуту или присваивания атрибуту.

exception Exception

Общий базовый класс для всех исключений, не приводящих к завершению системы.

exception ImportError

Возникает, когда инструкции import не удаётся найти определение модуля.

exception IndexError

Возникает, когда индекс последовательности выходит за пределы диапазона.

exception KeyboardInterrupt

Возникает, когда пользователь прерывает выполнение программы, обычно нажатием Ctrl+C в REPL.

См. также в контексте Программный кирпич (failure to boot).

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

Возникает, когда второй аргумент операции деления или взятия остатка равен нулю.