`builtins` — funcții și excepții încorporate#

Toate funcțiile și excepțiile încorporate sunt descrise aici. Ele sunt de asemenea disponibile prin intermediul modulului builtins.

Funcții și tipuri#

abs(x: Any) → Any#: Returnează valoarea absolută a unui număr. Argumentul poate fi un întreg, un număr cu virgulă mobilă sau orice obiect care implementează __abs__().

all(iterable: Iterable[Any]) → bool#: Returnează True dacă toate elementele lui iterable sunt adevărate (sau dacă iterabilul este gol).

any(iterable: Iterable[Any]) → bool#: Returnează True dacă oricare element al lui iterable este adevărat. Returnează False dacă iterabilul este gol.

bin(x: int) → str#: Convertește un întreg într-un șir binar prefixat cu "0b". Argumentul trebuie să fie un întreg Python sau să implementeze __index__().

class bool(x: Any = False)#: Returnează o valoare booleană, adică una dintre True sau False. x este convertit folosind procedura standard de testare a adevărului.

class bytearray(source: int | str | Iterable[int] | bytes = b'', encoding: str = 'utf-8', errors: str = 'strict')#

Secvență mutabilă de întregi în intervalul 0-255. Construcția urmează aceleași reguli ca bytes: dintr-un întreg (creând un tampon umplut cu zerouri de dimensiunea respectivă), dintr-un iterabil de întregi, dintr-un șir cu encoding sau din orice obiect care respectă protocolul buffer. Acceptă operațiile standard pe secvențe plus modificarea pe loc.

classmethod fromhex(string: str) → bytearray#: Construiește un bytearray dintr-un șir de perechi de cifre hexazecimale. Spațiile albe dintre perechile de cifre sunt ignorate; un caracter non-hexazecimal generează ValueError.

append(val: int) → None#: Adaugă o singură valoare (un întreg în intervalul 0-255) la sfârșitul bytearray-ului, mărindu-l cu un octet.

center(width: int, fillbyte: bytes) → bytes#: Returnează o copie a conținutului centrată într-o secvență de lungime width, completată cu fillbyte. Spre deosebire de CPython, fillbyte este obligatoriu. Datele sunt returnate nemodificate când width nu este mai mare decât lungimea curentă.

count(sub: bytes, start: int = 0, end: int = -1) → int#: Returnează numărul de apariții care nu se suprapun ale lui sub în felia [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool#: Returnează True dacă conținutul se termină cu suffix. Spre deosebire de CPython, suffix nu poate fi un tuplu de valori.

extend(iterable: Iterable[int]) → None#: Adaugă toate elementele din iterable la sfârșitul bytearray-ului. Ca extensie față de CPython, poate fi folosit orice obiect care respectă protocolul buffer.

find(sub: bytes, start: int = 0, end: int = -1) → int#: Returnează cel mai mic indice unde sub este găsit în felia [start:end], sau -1 dacă nu este găsit.

format(*args: Any, **kwargs: Any) → str#: Efectuează o operație de formatare a șirurilor folosind conținutul ca șir de format, returnând rezultatul formatat.

hex(sep: str = '') → str#: Returnează un șir de două cifre hexazecimale pentru fiecare octet. Dacă este dat opționalul sep (un șir de lungime 1), acesta este inserat între valorile consecutive ale octeților.

index(sub: bytes, start: int = 0, end: int = -1) → int#: Ca find(), dar generează ValueError când sub nu este găsit.

isalpha() → bool#: Returnează True dacă toți octeții sunt caractere alfabetice ASCII și există cel puțin un octet, altfel False.

isdigit() → bool#: Returnează True dacă toți octeții sunt cifre zecimale ASCII și există cel puțin un octet, altfel False.

islower() → bool#: Returnează True dacă toți octeții cu majuscule/minuscule sunt minuscule și există cel puțin un octet cu majuscule/minuscule, altfel False.

isspace() → bool#: Returnează True dacă toți octeții sunt spații albe ASCII și există cel puțin un octet, altfel False.

isupper() → bool#: Returnează True dacă toți octeții cu majuscule/minuscule sunt majuscule și există cel puțin un octet cu majuscule/minuscule, altfel False.

join(iterable: Iterable[bytes]) → bytes#: Returnează un obiect bytes care este concatenarea elementelor din iterable, folosind conținutul bytearray-ului ca separator.

lower() → bytes#: Returnează o copie a conținutului cu toate caracterele majuscule ASCII convertite în minuscule.

lstrip(chars: bytes | None = None) → bytes#: Returnează o copie cu octeții de la început eliminați. chars specifică setul de octeți de eliminat; dacă este omis sau None, sunt eliminate spațiile albe ASCII.

partition(sep: bytes) → tuple#: Împarte la prima apariție a lui sep, returnând (head, sep, tail). Dacă sep nu este găsit, returnează conținutul urmat de două obiecte goale.

replace(old: bytes, new: bytes, count: int = -1) → bytes#: Returnează o copie cu toate aparițiile lui old înlocuite cu new. Dacă este dat count, sunt înlocuite doar primele count apariții.

rfind(sub: bytes, start: int = 0, end: int = -1) → int#: Returnează cel mai mare indice unde sub este găsit în felia [start:end], sau -1 dacă nu este găsit.

rindex(sub: bytes, start: int = 0, end: int = -1) → int#: Ca rfind(), dar generează ValueError când sub nu este găsit.

rpartition(sep: bytes) → tuple#: Împarte la ultima apariție a lui sep, returnând (head, sep, tail). Dacă sep nu este găsit, returnează două obiecte goale urmate de conținut.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list#: Împarte la aparițiile lui sep într-o listă de fragmente, efectuând cel mult maxsplit împărțiri numărând de la dreapta. Dacă sep este None sau omis, împarte la secvențe de spații albe ASCII.

rstrip(chars: bytes | None = None) → bytes#: Returnează o copie cu octeții de la sfârșit eliminați. chars specifică setul de octeți de eliminat; dacă este omis sau None, sunt eliminate spațiile albe ASCII.

split(sep: bytes | None = None, maxsplit: int = -1) → list#: Împarte la aparițiile lui sep într-o listă de fragmente. Dacă sep este None sau omis, împarte la secvențe de spații albe ASCII, iar spațiile albe de la început/sfârșit sunt ignorate.

splitlines(keepends: bool = False) → list#: Returnează o listă a liniilor, întrerupând la \n, \r și \r\n. Întreruperile de linie sunt excluse decât dacă keepends este adevărat.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool#: Returnează True dacă conținutul începe cu prefix. Spre deosebire de CPython, prefix nu poate fi un tuplu, iar end este acceptat dar ignorat.

strip(chars: bytes | None = None) → bytes#: Returnează o copie cu octeții de la început și de la sfârșit eliminați. chars specifică setul de octeți de eliminat; dacă este omis sau None, sunt eliminate spațiile albe ASCII.

upper() → bytes#: Returnează o copie a conținutului cu toate caracterele minuscule ASCII convertite în majuscule.

class bytes(source: int | str | Iterable[int] = b'', encoding: str = 'utf-8', errors: str = 'strict')#

Secvență imutabilă de întregi în intervalul 0-255. Creată dintr-un întreg (tampon umplut cu zerouri), dintr-un iterabil de întregi, dintr-un șir cu encoding sau din orice obiect care respectă protocolul buffer. Literalii bytes folosesc sintaxa b'...'.

classmethod fromhex(string: str) → bytes#: Construiește un obiect bytes dintr-un șir de perechi de cifre hexazecimale. Spațiile albe dintre perechile de cifre sunt ignorate; un caracter non-hexazecimal generează ValueError.

center(width: int, fillbyte: bytes) → bytes#: Returnează o copie centrată într-o secvență de lungime width, completată cu fillbyte (un bytes de lungime 1 care dă octetul de completare). Spre deosebire de CPython, fillbyte este obligatoriu. Obiectul original este returnat nemodificat când width nu este mai mare decât lungimea sa.

count(sub: bytes, start: int = 0, end: int = -1) → int#: Returnează numărul de apariții care nu se suprapun ale lui sub în felia [start:end].

decode(encoding: str = 'utf-8') → str#: Returnează un str decodificat din octeți. În MicroPython argumentul encoding este acceptat dar efectiv ignorat (octeții sunt reinterpretați ca UTF-8).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool#: Returnează True dacă octeții se termină cu suffix. Spre deosebire de CPython, suffix nu poate fi un tuplu de valori de încercat.

find(sub: bytes, start: int = 0, end: int = -1) → int#: Returnează cel mai mic indice unde subsecvența sub este găsită în felia [start:end], sau -1 dacă nu este găsită.

format(*args: Any, **kwargs: Any) → str#: Efectuează o operație de formatare a șirurilor folosind octeții ca șir de format, returnând rezultatul formatat.

hex(sep: str = '') → str#: Returnează un șir de două cifre hexazecimale pentru fiecare octet. Dacă este dat opționalul sep (un șir de lungime 1), acesta este inserat între valorile consecutive ale octeților.

index(sub: bytes, start: int = 0, end: int = -1) → int#: Ca find(), dar generează ValueError când sub nu este găsit.

isalpha() → bool#: Returnează True dacă toți octeții sunt caractere alfabetice ASCII și există cel puțin un octet, altfel False.

isdigit() → bool#: Returnează True dacă toți octeții sunt cifre zecimale ASCII și există cel puțin un octet, altfel False.

islower() → bool#: Returnează True dacă toți octeții cu majuscule/minuscule sunt minuscule și există cel puțin un octet cu majuscule/minuscule, altfel False.

isspace() → bool#: Returnează True dacă toți octeții sunt spații albe ASCII și există cel puțin un octet, altfel False.

isupper() → bool#: Returnează True dacă toți octeții cu majuscule/minuscule sunt majuscule și există cel puțin un octet cu majuscule/minuscule, altfel False.

join(iterable: Iterable[bytes]) → bytes#: Returnează un obiect bytes care este concatenarea elementelor din iterable, folosind obiectul bytes însuși ca separator.

lower() → bytes#: Returnează o copie cu toate caracterele majuscule ASCII convertite în minuscule.

lstrip(chars: bytes | None = None) → bytes#: Returnează o copie cu octeții de la început eliminați. chars specifică setul de octeți de eliminat; dacă este omis sau None, sunt eliminate spațiile albe ASCII.

partition(sep: bytes) → tuple#: Împarte la prima apariție a lui sep, returnând (head, sep, tail). Dacă sep nu este găsit, returnează octeții urmați de două obiecte bytes goale.

replace(old: bytes, new: bytes, count: int = -1) → bytes#: Returnează o copie cu toate aparițiile lui old înlocuite cu new. Dacă este dat count, sunt înlocuite doar primele count apariții.

rfind(sub: bytes, start: int = 0, end: int = -1) → int#: Returnează cel mai mare indice unde sub este găsit în felia [start:end], sau -1 dacă nu este găsit.

rindex(sub: bytes, start: int = 0, end: int = -1) → int#: Ca rfind(), dar generează ValueError când sub nu este găsit.

rpartition(sep: bytes) → tuple#: Împarte la ultima apariție a lui sep, returnând (head, sep, tail). Dacă sep nu este găsit, returnează două obiecte bytes goale urmate de octeți.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list#: Împarte la aparițiile lui sep într-o listă de fragmente, efectuând cel mult maxsplit împărțiri numărând de la dreapta. Dacă sep este None sau omis, împarte la secvențe de spații albe ASCII.

rstrip(chars: bytes | None = None) → bytes#: Returnează o copie cu octeții de la sfârșit eliminați. chars specifică setul de octeți de eliminat; dacă este omis sau None, sunt eliminate spațiile albe ASCII.

split(sep: bytes | None = None, maxsplit: int = -1) → list#: Împarte la aparițiile lui sep într-o listă de fragmente. Dacă sep este None sau omis, împarte la secvențe de spații albe ASCII, iar spațiile albe de la început/sfârșit sunt ignorate.

splitlines(keepends: bool = False) → list#: Returnează o listă a liniilor, întrerupând la \n, \r și \r\n. Întreruperile de linie sunt excluse decât dacă keepends este adevărat.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool#: Returnează True dacă octeții încep cu prefix. Spre deosebire de CPython, prefix nu poate fi un tuplu, iar end este acceptat dar ignorat.

strip(chars: bytes | None = None) → bytes#: Returnează o copie cu octeții de la început și de la sfârșit eliminați. chars specifică setul de octeți de eliminat; dacă este omis sau None, sunt eliminate spațiile albe ASCII.

upper() → bytes#: Returnează o copie cu toate caracterele minuscule ASCII convertite în majuscule.

callable(obj: Any) → bool#: Returnează True dacă obj pare apelabil, False altfel.

chr(i: int) → str#: Returnează un șir de un caracter al cărui punct de cod Unicode este întregul i.

classmethod(func: Callable[..., Any]) → classmethod#: Transformă o metodă într-o metodă de clasă. Folosită de obicei ca decorator.

compile(source: str | bytes, filename: str, mode: str) → Any#: Compilează source într-un obiect cod care poate fi executat de exec() sau eval(). mode este unul dintre "exec", "eval" sau "single".

class complex(real: float | str = 0, imag: float = 0)#: Creează un număr complex dintr-o parte reală și una imaginară, sau dintr-un șir.

delattr(obj, name: str) → None#: Argumentul name trebuie să fie un șir, iar această funcție șterge atributul numit din obiectul dat de obj.

class dict(*args, **kwargs)#

Creează un dicționar nou. Echivalent cu dict din CPython.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict#: Creează un dicționar nou cu chei preluate din iterable, fiecare mapată la value (implicit None). Apelată pe tip, de exemplu dict.fromkeys(...).

clear() → None#: Elimină toate elementele din dicționar, lăsându-l gol. Generează TypeError dacă dicționarul este fix (doar pentru citire).

copy() → dict#: Returnează o copie superficială a dicționarului. Obiectul returnat are același tip ca originalul (dict sau OrderedDict) dar nu este fix.

get(key: Any, default: Any = None) → Any#: Returnează valoarea pentru key dacă aceasta este în dicționar, altfel returnează default (care el însuși are valoarea implicită None, deci aceasta nu generează niciodată KeyError). Dicționarul nu este modificat.

items() → Any#: Returnează un obiect de vizualizare dinamic asupra perechilor (key, value) care reflectă modificările ulterioare ale dicționarului și acceptă iterarea, len(), operatorul in și operatorii de comparare a mulțimilor.

keys() → Any#: Returnează un obiect de vizualizare dinamic asupra cheilor care reflectă modificările ulterioare ale dicționarului și acceptă iterarea, len(), operatorul in și operatorii de comparare a mulțimilor.

pop(key: Any, default: Any = None) → Any#: Elimină key din dicționar și returnează valoarea sa. Dacă key nu este prezentă, returnează default dacă a fost furnizat; altfel generează KeyError. Generează TypeError dacă dicționarul este fix.

popitem() → tuple#: Elimină și returnează o pereche (key, value) arbitrară ca tuplu de 2 elemente. Pentru un dict obișnuit, perechea aleasă este nespecificată; pentru un OrderedDict este eliminată ultima pereche inserată (LIFO). Generează KeyError dacă dicționarul este gol, sau TypeError dacă este fix.

setdefault(key: Any, default: Any = None) → Any#: Dacă key este în dicționar, returnează valoarea sa. Altfel inserează key cu o valoare default (implicit None) și returnează acea valoare. Generează TypeError dacă dicționarul este fix.

update(*args: Any, **kwargs: Any) → None#: Actualizează dicționarul pe loc. Este acceptat cel mult un argument pozițional: fie un alt dicționar, fie un iterabil de perechi (key, value) cu două elemente (fiecare trebuie să producă exact două elemente, altfel se generează ValueError). Argumentele cu cuvinte-cheie sunt apoi adăugate ca intrări cu chei de tip șir. Cheile existente sunt suprascrise. Generează TypeError dacă dicționarul este fix.

values() → Any#: Returnează un obiect de vizualizare dinamic asupra valorilor care reflectă modificările ulterioare ale dicționarului și acceptă iterarea și len().

__getitem__(key: Any) → Any#: Returnează self[key]. Implementează operatorul de indexare d[key]; generează KeyError dacă key nu este prezentă.

__setitem__(key: Any, value: Any) → None#: Setează self[key] la value. Implementează d[key] = value.

__delitem__(key: Any) → None#: Șterge self[key]. Implementează del d[key]; generează KeyError dacă key nu este prezentă.

dir(obj: Any = None) → list#: Fără argumente, returnează lista numelor din domeniul local curent. Cu un argument, returnează o listă a atributelor valide pentru acel obiect.

divmod(a: Any, b: Any) → tuple#: Returnează perechea (a // b, a % b) ca tuplu, pentru două numere (non-complexe).

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]#: Returnează un obiect enumerate care produce perechi (index, value) din iterable, cu indicele începând de la start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any#: Evaluează o expresie Python dată ca șir (sau ca obiect cod compilat) și returnează rezultatul.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None#: Execută dinamic cod Python furnizat ca șir sau ca obiect cod compilat.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]#: Construiește un iterator din acele elemente ale lui iterable pentru care function returnează adevărat. Dacă function este None, se presupune funcția identitate.

class float(x: str | bytes | int | float = 0.0)#: Returnează un număr cu virgulă mobilă construit dintr-un număr sau un șir x.

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

Returnează un nou obiect frozenset, opțional cu elemente preluate din iterable. frozenset este o variantă imutabilă și hashabilă a lui set.

copy() → frozenset#: Returnează o copie superficială a frozenset-ului.

difference(*others: Iterable[Any]) → frozenset#: Returnează un nou frozenset cu elementele din frozenset care nu se află în niciunul dintre others. Fiecare argument poate fi orice iterabil.

intersection(other: Iterable[Any]) → frozenset#: Returnează un nou frozenset cu elementele comune frozenset-ului și lui other. În MicroPython este acceptat doar un singur argument other (CPython acceptă mai multe).

isdisjoint(other: Iterable[Any]) → bool#: Returnează True dacă frozenset-ul nu are niciun element comun cu other.

issubset(other: Iterable[Any]) → bool#: Returnează True dacă fiecare element al frozenset-ului se află în other.

issuperset(other: Iterable[Any]) → bool#: Returnează True dacă fiecare element al lui other se află în frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset#: Returnează un nou frozenset cu elementele aflate fie în frozenset, fie în other, dar nu în ambele. În MicroPython este acceptat doar un singur argument other.

union(other: Iterable[Any]) → frozenset#: Returnează un nou frozenset cu elementele din frozenset și din other. În MicroPython este acceptat doar un singur argument other (CPython acceptă mai multe).

getattr(obj: Any, name: str, default: Any = None) → Any#: Returnează valoarea atributului numit al lui obj. Dacă atributul nu există, este returnat default dacă este furnizat, altfel se generează AttributeError.

globals() → dict#: Returnează un dicționar care reprezintă tabelul de simboluri globale al modulului curent.

hasattr(obj: Any, name: str) → bool#: Returnează True dacă obj are un atribut cu numele name dat, False altfel.

hash(obj: Any) → int#: Returnează valoarea hash a lui obj (dacă are una). Valorile hash sunt întregi folosiți pentru a compara rapid cheile unui dicționar în timpul unei căutări în dicționar.

hex(x: int) → str#: Convertește un întreg într-un șir hexazecimal cu minuscule prefixat cu "0x".

id(obj: Any) → int#: Returnează identitatea unui obiect. Acesta este un întreg care este garantat unic și constant pentru acest obiect pe durata existenței sale.

input(prompt: str = '') → str#: Citește o linie de la intrarea standard și o returnează ca șir (fără caracterul de linie nouă de la sfârșit). Dacă este dat prompt, acesta este scris la ieșirea standard fără un caracter de linie nouă la sfârșit, mai întâi.

class int(x: str | bytes | int | float = 0, base: int = 10)#

classmethod from_bytes(bytes: bytes, byteorder: str) → int#: În MicroPython, parametrul byteorder trebuie să fie pozițional (acest lucru este compatibil cu CPython).

to_bytes(size: int, byteorder: str) → bytes#: În MicroPython, parametrul byteorder trebuie să fie pozițional (acest lucru este compatibil cu CPython).

Notă
Argumentul opțional signed din CPython nu este acceptat. MicroPython convertește în prezent întregii negativi ca având semn, iar pe cei pozitivi ca fără semn. (Detalii.)

isinstance(obj: Any, classinfo: type | tuple) → bool#: Returnează True dacă obj este o instanță a lui classinfo sau a oricăreia dintre subclasele sale. classinfo poate fi o clasă sau un tuplu de clase.

issubclass(cls: type, classinfo: type | tuple) → bool#: Returnează True dacă cls este o subclasă (directă, indirectă sau virtuală) a lui classinfo.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]#: Returnează un obiect iterator. Cu un argument, obj trebuie să accepte protocolul de iterare. Cu două argumente, obj trebuie să fie apelabil, iar iterarea se oprește când acesta returnează sentinel.

len(obj: Any) → int#: Returnează numărul de elemente dintr-un container.

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

Construiește o listă nouă, opțional populată cu elemente din iterable.

append(object: Any) → None#: Adaugă object la sfârșitul listei.

clear() → None#: Elimină toate elementele din listă, lăsând-o goală.

copy() → list#: Returnează o copie superficială a listei.

count(value: Any) → int#: Returnează numărul de elemente din listă care sunt egale cu value.

extend(iterable: Iterable[Any]) → None#: Adaugă toate elementele din iterable la sfârșitul listei. Dacă iterable este el însuși o listă, elementele sale sunt copiate direct; altfel se iterează asupra lui.

index(value: Any, start: int = 0, stop: int = -1) → int#: Returnează indicele primului element egal cu value, căutând în felia [start:stop]. Generează ValueError dacă value nu este prezent.

insert(index: int, object: Any) → None#: Inserează object înaintea poziției index. Un index negativ este interpretat relativ la sfârșitul listei, iar indicele este limitat la intervalul valid (deci valorile dincolo de oricare capăt inserează la început sau la sfârșit).

pop(index: int = -1) → Any#: Elimină și returnează elementul de la index (ultimul element în mod implicit). Generează IndexError dacă lista este goală sau index este în afara intervalului.

remove(value: Any) → None#: Elimină primul element egal cu value. Generează ValueError dacă value nu este prezent.

reverse() → None#: Inversează elementele listei pe loc.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None#: Sortează elementele listei pe loc. key și reverse sunt doar cu cuvânt-cheie. key, dacă este dat, este o funcție aplicată fiecărui element pentru a produce valoarea de comparare; reverse sortează în ordine descrescătoare.

Notă
Spre deosebire de CPython, sortarea listelor în MicroPython nu este stabilă.

locals() → dict#: Returnează un dicționar care reprezintă tabelul de simboluri locale curent.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]#: Returnează un iterator care aplică function fiecărui element al lui iterables, producând rezultatele.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any#: Cu un singur argument iterabil, returnează cel mai mare element al său. Cu două sau mai multe argumente, returnează cel mai mare argument.

class memoryview(obj: Any)#: Creează un memoryview care referențiază obj, care trebuie să accepte protocolul buffer (de exemplu bytes, bytearray, array.array). Permite accesul și felierea fără copiere a memoriei subiacente; felierea unui memoryview returnează un alt memoryview în loc de o copie.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any#: Cu un singur argument iterabil, returnează cel mai mic element al său. Cu două sau mai multe argumente, returnează cel mai mic argument.

next(iterator: Iterator[Any], default: Any = None) → Any#: Recuperează următorul element din iterator. Dacă este dat default și iteratorul este epuizat, este returnat default în loc să se genereze StopIteration.

class object#: Returnează un nou obiect fără caracteristici. object este clasa de bază pentru toate clasele.

oct(x: int) → str#: Convertește un întreg într-un șir octal prefixat cu "0o".

open(file: str, mode: str = 'r', **kwargs) → Any#: Deschide file și returnează un obiect fișier corespunzător. mode are valoarea implicită "r" pentru citire de text.

ord(c: str) → int#: Returnează punctul de cod Unicode al unui șir format dintr-un singur caracter c ca întreg.

pow(base: Any, exp: Any, mod: Any | None = None) → Any#: Returnează base ridicat la puterea exp. Dacă este dat mod, returnează base ** exp % mod (calculat mai eficient decât forma explicită).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None#: Tipărește objects în fluxul de text file, separate prin sep și urmate de 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#: Returnează un atribut de tip proprietate. Folosit de obicei ca decorator pentru a defini atribute gestionate pe o clasă.

range(*args: int) → range#: Returnează o secvență imutabilă de întregi. Apelată ca range(stop), range(start, stop) sau range(start, stop, step).

repr(obj: Any) → str#: Returnează un șir care conține o reprezentare tipăribilă a lui obj.

reversed(seq: Any) → Iterator[Any]#: Returnează un iterator invers asupra valorilor secvenței date.

round(number: Any, ndigits: int | None = None) → Any#: Returnează number rotunjit la ndigits zecimale. Dacă ndigits este omis, returnează cel mai apropiat întreg.

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

Returnează un nou obiect set, opțional cu elemente preluate din iterable.

add(elem: Any) → None#: Adaugă elementul elem la set.

clear() → None#: Elimină toate elementele din set.

copy() → set#: Returnează o copie superficială a setului.

difference(*others: Iterable[Any]) → set#: Returnează un nou set cu elementele din set care nu se află în niciunul dintre others. Fiecare argument poate fi orice iterabil.

difference_update(*others: Iterable[Any]) → None#: Elimină din set toate elementele găsite în oricare dintre others (pe loc).

discard(elem: Any) → None#: Elimină elementul elem din set dacă este prezent. Spre deosebire de remove(), aceasta nu generează o eroare dacă elem este absent.

intersection(other: Iterable[Any]) → set#: Returnează un nou set cu elementele comune setului și lui other. În MicroPython este acceptat doar un singur argument other (CPython acceptă mai multe).

intersection_update(other: Iterable[Any]) → None#: Actualizează setul, păstrând doar elementele găsite și în other (pe loc). În MicroPython este acceptat doar un singur argument other.

isdisjoint(other: Iterable[Any]) → bool#: Returnează True dacă setul nu are niciun element comun cu other.

issubset(other: Iterable[Any]) → bool#: Returnează True dacă fiecare element al setului se află în other.

issuperset(other: Iterable[Any]) → bool#: Returnează True dacă fiecare element al lui other se află în set.

pop() → Any#: Elimină și returnează un element arbitrar din set. Generează KeyError dacă setul este gol.

remove(elem: Any) → None#: Elimină elementul elem din set. Generează KeyError dacă elem nu este conținut în set.

symmetric_difference(other: Iterable[Any]) → set#: Returnează un nou set cu elementele aflate fie în set, fie în other, dar nu în ambele. În MicroPython este acceptat doar un singur argument other.

symmetric_difference_update(other: Iterable[Any]) → None#: Actualizează setul, păstrând doar elementele găsite fie în set, fie în other, dar nu în ambele (pe loc). În MicroPython este acceptat doar un singur argument other.

union(other: Iterable[Any]) → set#: Returnează un nou set cu elementele din set și din other. În MicroPython este acceptat doar un singur argument other (CPython acceptă mai multe).

update(*others: Iterable[Any]) → None#: Actualizează setul, adăugând elemente din toate others (pe loc).

setattr(obj: Any, name: str, value: Any) → None#: Setează atributul numit pe obj la value. Omologul lui getattr().

class slice#: Tipul încorporat slice este tipul pe care îl au obiectele slice.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list#: Returnează o nouă listă sortată din elementele lui iterable.

staticmethod(func: Callable[..., Any]) → staticmethod#: Transformă o metodă într-o metodă statică. Folosită de obicei ca decorator.

class str(object: Any = '', encoding: str = 'utf-8', errors: str = 'strict')#

Returnează o versiune sub formă de șir a lui object. Dacă object este un obiect de tip bytes, argumentele encoding și errors controlează decodificarea.

center(width: int) → str#: Returnează o copie a șirului centrată într-un câmp de lungime width, completat cu spații. În MicroPython se folosește doar spațiul ca și caracter de completare (nu există un argument pentru caracterul de completare), iar șirul original este returnat nemodificat când width nu este mai mare decât lungimea sa.

count(sub: str, start: int = 0, end: int = -1) → int#: Returnează numărul de apariții care nu se suprapun ale lui sub în felia [start:end]. Un sub gol numără fiecare interval dintre caractere.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes#: Returnează un obiect bytes care codifică șirul. MicroPython ignoră efectiv argumentele și folosește UTF-8; errors este acceptat dar nu este luat în considerare. Echivalent cu bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool#: Returnează True dacă șirul se termină cu suffix dat, care poate fi un singur șir sau un tuplu de șiruri de încercat. Argumentele opționale start și end restrâng comparația la felia [start:end].

find(sub: str, start: int = 0, end: int = -1) → int#: Returnează cel mai mic indice din șir unde subșirul sub este găsit în felia [start:end], sau -1 dacă nu este găsit.

format(*args: Any, **kwargs: Any) → str#: Efectuează o operație de formatare a șirurilor, înlocuind câmpurile de înlocuire delimitate de acolade {} cu valori din args și kwargs. Acceptă mini-limbajul standard de specificare a formatului.

index(sub: str, start: int = 0, end: int = -1) → int#: Ca find(), dar generează ValueError când subșirul sub nu este găsit în felia [start:end].

isalpha() → bool#: Returnează True dacă toate caracterele din șir sunt alfabetice și șirul este nevid, altfel False.

isdigit() → bool#: Returnează True dacă toate caracterele din șir sunt cifre și șirul este nevid, altfel False.

islower() → bool#: Returnează True dacă șirul conține cel puțin un caracter alfabetic și toate astfel de caractere sunt minuscule, altfel False.

isspace() → bool#: Returnează True dacă toate caracterele din șir sunt spații albe și șirul este nevid, altfel False.

isupper() → bool#: Returnează True dacă șirul conține cel puțin un caracter alfabetic și toate astfel de caractere sunt majuscule, altfel False.

join(iterable: Iterable[str]) → str#: Concatenează șirurile din iterable, inserând acest șir ca separator între elemente. Elementele trebuie să fie șiruri, altfel se generează TypeError.

lower() → str#: Returnează o copie a șirului cu toate caracterele convertite în minuscule.

lstrip(chars: str | None = None) → str#: Returnează o copie a șirului cu caracterele de la început eliminate. Dacă chars este omis sau None, sunt eliminate spațiile albe; altfel chars este tratat ca un set de caractere de eliminat.

partition(sep: str) → tuple#: Împarte șirul la prima apariție a lui sep și returnează un tuplu de 3 elemente (head, sep, tail). Dacă sep nu este găsit, returnează (self, "", ""). Un sep gol generează ValueError.

replace(old: str, new: str, count: int = -1) → str#: Returnează o copie a șirului cu toate aparițiile subșirului old înlocuite cu new. Dacă este dat count și este nenegativ, sunt înlocuite doar primele count apariții.

rfind(sub: str, start: int = 0, end: int = -1) → int#: Returnează cel mai mare indice din șir unde subșirul sub este găsit în felia [start:end], sau -1 dacă nu este găsit.

rindex(sub: str, start: int = 0, end: int = -1) → int#: Ca rfind(), dar generează ValueError când subșirul sub nu este găsit în felia [start:end].

rpartition(sep: str) → tuple#: Împarte șirul la ultima apariție a lui sep și returnează un tuplu de 3 elemente (head, sep, tail). Dacă sep nu este găsit, returnează ("", "", self). Un sep gol generează ValueError.

rsplit(sep: str | None = None, maxsplit: int = -1) → list#: Împarte șirul de la dreapta într-o listă de subșiruri folosind sep ca delimitator, efectuând cel mult maxsplit împărțiri. Fără maxsplit (sau cu unul negativ) se comportă identic cu split(); în MicroPython rsplit(None, n) cu un n nenegativ generează NotImplementedError.

rstrip(chars: str | None = None) → str#: Returnează o copie a șirului cu caracterele de la sfârșit eliminate. Dacă chars este omis sau None, sunt eliminate spațiile albe; altfel chars este tratat ca un set de caractere de eliminat.

split(sep: str | None = None, maxsplit: int = -1) → list#: Împarte șirul într-o listă de subșiruri folosind sep ca delimitator, efectuând cel mult maxsplit împărțiri. Dacă sep este omis sau None, împarte la secvențe de spații albe, ignorând spațiile albe de la început; altfel un sep gol generează ValueError.

splitlines(keepends: bool = False) → list#: Returnează o listă a liniilor din șir, întrerupând la \n, \r și \r\n. Întreruperile de linie nu sunt incluse decât dacă keepends este adevărat.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool#: Returnează True dacă șirul începe cu prefix dat, care poate fi un singur șir sau un tuplu de șiruri de încercat. Argumentele opționale start și end restrâng comparația la felia [start:end].

strip(chars: str | None = None) → str#: Returnează o copie a șirului cu caracterele de la început și de la sfârșit eliminate. Dacă chars este omis sau None, sunt eliminate spațiile albe; altfel chars este tratat ca un set de caractere de eliminat.

upper() → str#: Returnează o copie a șirului cu toate caracterele convertite în majuscule.

sum(iterable: Iterable[Any], start: Any = 0) → Any#: Adună start și elementele lui iterable de la stânga la dreapta și returnează totalul.

super(type: type | None = None, obj_or_type: Any | None = None) → Any#: Returnează un obiect proxy care deleagă apelurile de metode către o clasă părinte sau soră a lui type. Util pentru accesarea metodelor moștenite care au fost suprascrise într-o clasă.

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

Construiește un nou tuplu, opțional populat cu elemente din iterable. Tuplurile sunt secvențe imutabile.

count(value: Any) → int#: Returnează numărul de elemente din tuplu care sunt egale cu value.

index(value: Any, start: int = 0, stop: int = -1) → int#: Returnează indicele primului element egal cu value, căutând în felia [start:stop]. Generează ValueError dacă value nu este prezent.

type(obj: Any) → type#: Cu un argument, returnează tipul lui obj. Valoarea returnată este un obiect tip.

zip(*iterables: Iterable[Any]) → Iterator[tuple]#: Returnează un iterator de tupluri, unde al i-lea tuplu conține al i-lea element din fiecare dintre iterabilele argument. Iterarea se oprește când cel mai scurt iterabil de intrare este epuizat.

Excepții#

exception AssertionError#: Generată când o instrucțiune assert eșuează.

exception AttributeError#: Generată când o referință sau o atribuire de atribut eșuează.

exception Exception#: Clasă de bază comună pentru toate excepțiile care nu duc la ieșirea din sistem.

exception ImportError#: Generată când o instrucțiune import nu reușește să găsească definiția modulului.

exception IndexError#: Generată când un indice de secvență este în afara intervalului.

exception KeyboardInterrupt#

Generată când utilizatorul întrerupe execuția programului, de obicei apăsând Ctrl+C în REPL.

A se vedea de asemenea în contextul Blocare software (eșec la pornire).

exception KeyError#: Generată când o cheie de mapare (dicționar) nu este găsită în setul de chei existente.

exception MemoryError#: Generată când o operație rămâne fără memorie.

exception NameError#: Generată când un nume local sau global nu este găsit.

exception NotImplementedError#: Generată când o metodă abstractă sau o caracteristică neimplementată este invocată.

exception OSError#: Generată când o funcție de sistem returnează o eroare legată de sistem.

exception RuntimeError#: Generată când este detectată o eroare care nu se încadrează în niciuna dintre celelalte categorii.

exception StopIteration#: Generată de next() și de metoda __next__() a unui iterator pentru a semnala că nu mai există elemente.

exception SyntaxError#: Generată când parserul întâlnește o eroare de sintaxă.

exception SystemExit#

Generată de sys.exit() pentru a solicita terminarea interpretorului. Spre deosebire de majoritatea excepțiilor, aceasta nu produce un traceback când nu este interceptată.

Pe OpenMV Cam, o excepție SystemExit neinterceptată cauzează în prezent un Resetare software al MicroPython.

exception TypeError#: Generată când o operație sau o funcție este aplicată unui obiect de tip nepotrivit.

exception ValueError#: Generată când o operație sau o funcție încorporată primește un argument de tipul corect dar cu o valoare nepotrivită.

exception ZeroDivisionError#: Generată când al doilea argument al unei operații de împărțire sau modulo este zero.

builtins — funcții și excepții încorporate#

Funcții și tipuri#

Excepții#

`builtins` — funcții și excepții încorporate#