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

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