`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 не є істинним.

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 (байт довжиною 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 не є істинним.

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) у вигляді двійки. Для звичайного 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).

Примітка
Необов’язковий kwarg 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 і ітератор вичерпано, повертається default замість виклику StopIteration.

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

Повертає новий об’єкт-множину, необов’язково з елементами, взятими з 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 і повертає тривалетний кортеж (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 і повертає тривалетний кортеж (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 не є істинним.

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.

Дивіться також у контексті Програмне «цеглування» (збій завантаження).

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#: Викликається, коли другий аргумент операції ділення або взяття залишку дорівнює нулю.

builtins — вбудовані функції та винятки#

Функції та типи#

Винятки#

`builtins` — вбудовані функції та винятки#