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.