`builtins` — funzioni ed eccezioni builtin#

Qui sono descritte tutte le funzioni e le eccezioni builtin. Sono disponibili anche tramite il modulo builtins.

Funzioni e tipi#

abs(x: Any) → Any#: Restituisce il valore assoluto di un numero. L’argomento puo essere un intero, un float o un qualsiasi oggetto che implementi __abs__().

all(iterable: Iterable[Any]) → bool#: Restituisce True se tutti gli elementi di iterable sono veri (o se l’iterabile e vuoto).

any(iterable: Iterable[Any]) → bool#: Restituisce True se almeno un elemento di iterable e vero. Restituisce False se l’iterabile e vuoto.

bin(x: int) → str#: Converte un intero in una stringa binaria preceduta dal prefisso "0b". L’argomento deve essere un intero Python o implementare __index__().

class bool(x: Any = False)#: Restituisce un valore booleano, ovvero True o False. x viene convertito usando la procedura standard di verifica della verita.

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

Sequenza mutabile di interi nell’intervallo 0-255. La costruzione segue le stesse regole di bytes: da un intero (creando un buffer riempito di zeri di quella dimensione), da un iterabile di interi, da una stringa con encoding, o da un qualsiasi oggetto che supporti il buffer protocol. Supporta le operazioni standard sulle sequenze oltre alla modifica sul posto.

classmethod fromhex(string: str) → bytearray#: Costruisce un bytearray da una stringa di coppie di cifre esadecimali. Gli spazi tra le coppie di cifre vengono ignorati; un carattere non esadecimale solleva ValueError.

append(val: int) → None#: Aggiunge un singolo valore (un intero nell’intervallo 0-255) alla fine del bytearray, facendolo crescere di un byte.

center(width: int, fillbyte: bytes) → bytes#: Restituisce una copia del contenuto centrata in una sequenza di lunghezza width, riempita con fillbyte. A differenza di CPython, fillbyte e obbligatorio. I dati vengono restituiti invariati quando width non e maggiore della lunghezza corrente.

count(sub: bytes, start: int = 0, end: int = -1) → int#: Restituisce il numero di occorrenze non sovrapposte di sub nella slice [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool#: Restituisce True se il contenuto termina con suffix. A differenza di CPython, suffix non puo essere una tupla di valori.

extend(iterable: Iterable[int]) → None#: Aggiunge tutti gli elementi di iterable alla fine del bytearray. Come estensione rispetto a CPython, e possibile usare qualsiasi oggetto che supporti il buffer protocol.

find(sub: bytes, start: int = 0, end: int = -1) → int#: Restituisce l’indice piu basso in cui sub viene trovato all’interno della slice [start:end], oppure -1 se non viene trovato.

format(*args: Any, **kwargs: Any) → str#: Esegue un’operazione di formattazione di stringa usando il contenuto come stringa di formato, restituendo il risultato formattato.

hex(sep: str = '') → str#: Restituisce una stringa di due cifre esadecimali per ogni byte. Se viene fornito l’argomento opzionale sep (una stringa di lunghezza 1), questo viene inserito tra i valori dei byte consecutivi.

index(sub: bytes, start: int = 0, end: int = -1) → int#: Come find(), ma solleva ValueError quando sub non viene trovato.

isalpha() → bool#: Restituisce True se tutti i byte sono caratteri ASCII alfabetici ed e presente almeno un byte, altrimenti False.

isdigit() → bool#: Restituisce True se tutti i byte sono cifre decimali ASCII ed e presente almeno un byte, altrimenti False.

islower() → bool#: Restituisce True se tutti i byte con distinzione maiuscole/minuscole sono minuscoli ed e presente almeno un byte di questo tipo, altrimenti False.

isspace() → bool#: Restituisce True se tutti i byte sono spazi bianchi ASCII ed e presente almeno un byte, altrimenti False.

isupper() → bool#: Restituisce True se tutti i byte con distinzione maiuscole/minuscole sono maiuscoli ed e presente almeno un byte di questo tipo, altrimenti False.

join(iterable: Iterable[bytes]) → bytes#: Restituisce un oggetto bytes che e la concatenazione degli elementi di iterable, usando il contenuto del bytearray come separatore.

lower() → bytes#: Restituisce una copia del contenuto con tutti i caratteri ASCII maiuscoli convertiti in minuscoli.

lstrip(chars: bytes | None = None) → bytes#: Restituisce una copia con i byte iniziali rimossi. chars specifica l’insieme di byte da rimuovere; se omesso o None, vengono rimossi gli spazi bianchi ASCII.

partition(sep: bytes) → tuple#: Divide alla prima occorrenza di sep, restituendo (head, sep, tail). Se sep non viene trovato, restituisce il contenuto seguito da due oggetti vuoti.

replace(old: bytes, new: bytes, count: int = -1) → bytes#: Restituisce una copia con tutte le occorrenze di old sostituite da new. Se viene fornito count, vengono sostituite solo le prime count occorrenze.

rfind(sub: bytes, start: int = 0, end: int = -1) → int#: Restituisce l’indice piu alto in cui sub viene trovato all’interno della slice [start:end], oppure -1 se non viene trovato.

rindex(sub: bytes, start: int = 0, end: int = -1) → int#: Come rfind(), ma solleva ValueError quando sub non viene trovato.

rpartition(sep: bytes) → tuple#: Divide all’ultima occorrenza di sep, restituendo (head, sep, tail). Se sep non viene trovato, restituisce due oggetti vuoti seguiti dal contenuto.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list#: Divide alle occorrenze di sep in una lista di parti, eseguendo al massimo maxsplit divisioni contando da destra. Se sep e None o viene omesso, divide alle sequenze di spazi bianchi ASCII.

rstrip(chars: bytes | None = None) → bytes#: Restituisce una copia con i byte finali rimossi. chars specifica l’insieme di byte da rimuovere; se omesso o None, vengono rimossi gli spazi bianchi ASCII.

split(sep: bytes | None = None, maxsplit: int = -1) → list#: Divide alle occorrenze di sep in una lista di parti. Se sep e None o viene omesso, divide alle sequenze di spazi bianchi ASCII.

splitlines(keepends: bool = False) → list#: Restituisce una lista delle righe, suddividendo a \n, \r e \r\n. Le interruzioni di riga sono escluse a meno che keepends non sia vero.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool#: Restituisce True se il contenuto inizia con prefix. A differenza di CPython, prefix non puo essere una tupla, e end viene accettato ma ignorato.

strip(chars: bytes | None = None) → bytes#: Restituisce una copia con i byte iniziali e finali rimossi. chars specifica l’insieme di byte da rimuovere; se omesso o None, vengono rimossi gli spazi bianchi ASCII.

upper() → bytes#: Restituisce una copia del contenuto con tutti i caratteri ASCII minuscoli convertiti in maiuscoli.

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

Sequenza immutabile di interi nell’intervallo 0-255. Creata da un intero (buffer riempito di zeri), da un iterabile di interi, da una stringa con encoding, o da un qualsiasi oggetto che supporti il buffer protocol. I letterali bytes usano la sintassi b'...'.

classmethod fromhex(string: str) → bytes#: Costruisce un oggetto bytes da una stringa di coppie di cifre esadecimali. Gli spazi tra le coppie di cifre vengono ignorati; un carattere non esadecimale solleva ValueError.

center(width: int, fillbyte: bytes) → bytes#: Restituisce una copia centrata in una sequenza di lunghezza width, riempita con fillbyte (un bytes di lunghezza 1 che fornisce il byte di riempimento). A differenza di CPython, fillbyte e obbligatorio. L’oggetto originale viene restituito invariato quando width non e maggiore della sua lunghezza.

count(sub: bytes, start: int = 0, end: int = -1) → int#: Restituisce il numero di occorrenze non sovrapposte di sub nella slice [start:end].

decode(encoding: str = 'utf-8') → str#: Restituisce una str decodificata dai byte. In MicroPython l’argomento encoding viene accettato ma di fatto ignorato (i byte vengono reinterpretati come UTF-8).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool#: Restituisce True se i byte terminano con suffix. A differenza di CPython, suffix non puo essere una tupla di valori da provare.

find(sub: bytes, start: int = 0, end: int = -1) → int#: Restituisce l’indice piu basso in cui la sottosequenza sub viene trovata all’interno della slice [start:end], oppure -1 se non viene trovata.

format(*args: Any, **kwargs: Any) → str#: Esegue un’operazione di formattazione di stringa usando i byte come stringa di formato, restituendo il risultato formattato.

hex(sep: str = '') → str#: Restituisce una stringa di due cifre esadecimali per ogni byte. Se viene fornito l’argomento opzionale sep (una stringa di lunghezza 1), questo viene inserito tra i valori dei byte consecutivi.

index(sub: bytes, start: int = 0, end: int = -1) → int#: Come find(), ma solleva ValueError quando sub non viene trovato.

isalpha() → bool#: Restituisce True se tutti i byte sono caratteri ASCII alfabetici ed e presente almeno un byte, altrimenti False.

isdigit() → bool#: Restituisce True se tutti i byte sono cifre decimali ASCII ed e presente almeno un byte, altrimenti False.

islower() → bool#: Restituisce True se tutti i byte con distinzione maiuscole/minuscole sono minuscoli ed e presente almeno un byte di questo tipo, altrimenti False.

isspace() → bool#: Restituisce True se tutti i byte sono spazi bianchi ASCII ed e presente almeno un byte, altrimenti False.

isupper() → bool#: Restituisce True se tutti i byte con distinzione maiuscole/minuscole sono maiuscoli ed e presente almeno un byte di questo tipo, altrimenti False.

join(iterable: Iterable[bytes]) → bytes#: Restituisce un oggetto bytes che e la concatenazione degli elementi di iterable, usando l’oggetto bytes stesso come separatore.

lower() → bytes#: Restituisce una copia con tutti i caratteri ASCII maiuscoli convertiti in minuscoli.

lstrip(chars: bytes | None = None) → bytes#: Restituisce una copia con i byte iniziali rimossi. chars specifica l’insieme di byte da rimuovere; se omesso o None, vengono rimossi gli spazi bianchi ASCII.

partition(sep: bytes) → tuple#: Divide alla prima occorrenza di sep, restituendo (head, sep, tail). Se sep non viene trovato, restituisce i byte seguiti da due oggetti bytes vuoti.

replace(old: bytes, new: bytes, count: int = -1) → bytes#: Restituisce una copia con tutte le occorrenze di old sostituite da new. Se viene fornito count, vengono sostituite solo le prime count occorrenze.

rfind(sub: bytes, start: int = 0, end: int = -1) → int#: Restituisce l’indice piu alto in cui sub viene trovato all’interno della slice [start:end], oppure -1 se non viene trovato.

rindex(sub: bytes, start: int = 0, end: int = -1) → int#: Come rfind(), ma solleva ValueError quando sub non viene trovato.

rpartition(sep: bytes) → tuple#: Divide all’ultima occorrenza di sep, restituendo (head, sep, tail). Se sep non viene trovato, restituisce due oggetti bytes vuoti seguiti dai byte.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list#: Divide alle occorrenze di sep in una lista di parti, eseguendo al massimo maxsplit divisioni contando da destra. Se sep e None o viene omesso, divide alle sequenze di spazi bianchi ASCII.

rstrip(chars: bytes | None = None) → bytes#: Restituisce una copia con i byte finali rimossi. chars specifica l’insieme di byte da rimuovere; se omesso o None, vengono rimossi gli spazi bianchi ASCII.

split(sep: bytes | None = None, maxsplit: int = -1) → list#: Divide alle occorrenze di sep in una lista di parti. Se sep e None o viene omesso, divide alle sequenze di spazi bianchi ASCII.

splitlines(keepends: bool = False) → list#: Restituisce una lista delle righe, suddividendo a \n, \r e \r\n. Le interruzioni di riga sono escluse a meno che keepends non sia vero.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool#: Restituisce True se i byte iniziano con prefix. A differenza di CPython, prefix non puo essere una tupla, e end viene accettato ma ignorato.

strip(chars: bytes | None = None) → bytes#: Restituisce una copia con i byte iniziali e finali rimossi. chars specifica l’insieme di byte da rimuovere; se omesso o None, vengono rimossi gli spazi bianchi ASCII.

upper() → bytes#: Restituisce una copia con tutti i caratteri ASCII minuscoli convertiti in maiuscoli.

callable(obj: Any) → bool#: Restituisce True se obj appare richiamabile, False altrimenti.

chr(i: int) → str#: Restituisce una stringa di un carattere il cui code point Unicode e l’intero i.

classmethod(func: Callable[..., Any]) → classmethod#: Trasforma un metodo in un metodo di classe. Tipicamente usato come decoratore.

compile(source: str | bytes, filename: str, mode: str) → Any#: Compila source in un oggetto codice che puo essere eseguito da exec() o eval(). mode e uno tra "exec", "eval" o "single".

class complex(real: float | str = 0, imag: float = 0)#: Crea un numero complesso da una parte reale e una immaginaria, o da una stringa.

delattr(obj, name: str) → None#: L’argomento name deve essere una stringa, e questa funzione elimina l’attributo indicato dall’oggetto fornito da obj.

class dict(*args, **kwargs)#

Crea un nuovo dizionario. Equivalente a dict di CPython.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict#: Crea un nuovo dizionario con chiavi prese da iterable, ciascuna associata a value (con valore predefinito None). Chiamato sul tipo, ad esempio dict.fromkeys(...).

clear() → None#: Rimuove tutti gli elementi dal dizionario, lasciandolo vuoto. Solleva TypeError se il dizionario e fisso (di sola lettura).

copy() → dict#: Restituisce una copia superficiale del dizionario. L’oggetto restituito ha lo stesso tipo dell’originale (dict o OrderedDict) ma non e fisso.

get(key: Any, default: Any = None) → Any#: Restituisce il valore per key se e presente nel dizionario, altrimenti restituisce default (che a sua volta vale None per impostazione predefinita, quindi questo non solleva mai KeyError). Il dizionario non viene modificato.

items() → Any#: Restituisce un oggetto vista dinamica sulle coppie (key, value) che riflette le modifiche successive al dizionario e supporta l’iterazione, len(), l’operatore in e gli operatori di confronto tra insiemi.

keys() → Any#: Restituisce un oggetto vista dinamica sulle chiavi che riflette le modifiche successive al dizionario e supporta l’iterazione, len(), l’operatore in e gli operatori di confronto tra insiemi.

pop(key: Any, default: Any = None) → Any#: Rimuove key dal dizionario e restituisce il suo valore. Se key non e presente, restituisce default se e stato fornito; altrimenti solleva KeyError. Solleva TypeError se il dizionario e fisso.

popitem() → tuple#: Rimuove e restituisce una coppia (key, value) arbitraria come tupla di 2 elementi. Per un normale dict la coppia scelta non e specificata; per un OrderedDict viene rimossa l’ultima coppia inserita (LIFO). Solleva KeyError se il dizionario e vuoto, oppure TypeError se e fisso.

setdefault(key: Any, default: Any = None) → Any#: Se key e presente nel dizionario, restituisce il suo valore. Altrimenti inserisce key con un valore pari a default (con valore predefinito None) e restituisce quel valore. Solleva TypeError se il dizionario e fisso.

update(*args: Any, **kwargs: Any) → None#: Aggiorna il dizionario sul posto. Viene accettato al massimo un argomento posizionale: o un altro dizionario, o un iterabile di coppie (key, value) di due elementi (ciascuna deve produrre esattamente due elementi, altrimenti viene sollevata ValueError). Gli argomenti keyword vengono poi aggiunti come voci con chiave di tipo stringa. Le chiavi esistenti vengono sovrascritte. Solleva TypeError se il dizionario e fisso.

values() → Any#: Restituisce un oggetto vista dinamica sui valori che riflette le modifiche successive al dizionario e supporta l’iterazione e len().

__getitem__(key: Any) → Any#: Restituisce self[key]. Implementa l’operatore di indicizzazione d[key]; solleva KeyError se key non e presente.

__setitem__(key: Any, value: Any) → None#: Imposta self[key] a value. Implementa d[key] = value.

__delitem__(key: Any) → None#: Elimina self[key]. Implementa del d[key]; solleva KeyError se key non e presente.

dir(obj: Any = None) → list#: Senza argomenti, restituisce la lista dei nomi nell’ambito locale corrente. Con un argomento, restituisce una lista degli attributi validi per quell’oggetto.

divmod(a: Any, b: Any) → tuple#: Restituisce la coppia (a // b, a % b) come tupla, per due numeri (non complessi).

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]#: Restituisce un oggetto enumerate che produce coppie (index, value) da iterable, con l’indice che parte da start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any#: Valuta un’espressione Python fornita come stringa (o come oggetto codice compilato) e restituisce il risultato.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None#: Esegue dinamicamente codice Python fornito come stringa o come oggetto codice compilato.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]#: Costruisce un iteratore a partire dagli elementi di iterable per i quali function restituisce vero. Se function e None, si assume la funzione identita.

class float(x: str | bytes | int | float = 0.0)#: Restituisce un numero in virgola mobile costruito da un numero o da una stringa x.

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

Restituisce un nuovo oggetto frozenset, opzionalmente con elementi presi da iterable. frozenset e una variante immutabile e hashable di set.

copy() → frozenset#: Restituisce una copia superficiale del frozenset.

difference(*others: Iterable[Any]) → frozenset#: Restituisce un nuovo frozenset con gli elementi del frozenset che non sono presenti in nessuno di others. Ogni argomento puo essere un qualsiasi iterabile.

intersection(other: Iterable[Any]) → frozenset#: Restituisce un nuovo frozenset con gli elementi comuni al frozenset e a other. In MicroPython viene accettato un solo argomento other (CPython ne accetta piu di uno).

isdisjoint(other: Iterable[Any]) → bool#: Restituisce True se il frozenset non ha elementi in comune con other.

issubset(other: Iterable[Any]) → bool#: Restituisce True se ogni elemento del frozenset e presente in other.

issuperset(other: Iterable[Any]) → bool#: Restituisce True se ogni elemento di other e presente nel frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset#: Restituisce un nuovo frozenset con gli elementi presenti nel frozenset o in other ma non in entrambi. In MicroPython viene accettato un solo argomento other.

union(other: Iterable[Any]) → frozenset#: Restituisce un nuovo frozenset con gli elementi del frozenset e di other. In MicroPython viene accettato un solo argomento other (CPython ne accetta piu di uno).

getattr(obj: Any, name: str, default: Any = None) → Any#: Restituisce il valore dell’attributo indicato di obj. Se l’attributo non esiste, viene restituito default se fornito, altrimenti viene sollevata AttributeError.

globals() → dict#: Restituisce un dizionario che rappresenta la tabella globale dei simboli del modulo corrente.

hasattr(obj: Any, name: str) → bool#: Restituisce True se obj ha un attributo con il name indicato, False altrimenti.

hash(obj: Any) → int#: Restituisce il valore di hash di obj (se ne ha uno). I valori di hash sono interi usati per confrontare rapidamente le chiavi di un dizionario durante una ricerca nel dizionario.

hex(x: int) → str#: Converte un intero in una stringa esadecimale minuscola preceduta dal prefisso "0x".

id(obj: Any) → int#: Restituisce l’identita di un oggetto. Si tratta di un intero garantito unico e costante per questo oggetto durante la sua vita.

input(prompt: str = '') → str#: Legge una riga dallo standard input e la restituisce come stringa (senza il newline finale). Se viene fornito prompt, questo viene scritto sullo standard output senza un newline finale prima.

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

classmethod from_bytes(bytes: bytes, byteorder: str) → int#: In MicroPython, il parametro byteorder deve essere posizionale (questo e compatibile con CPython).

to_bytes(size: int, byteorder: str) → bytes#: In MicroPython, il parametro byteorder deve essere posizionale (questo e compatibile con CPython).

Nota
Il kwarg opzionale signed di CPython non e supportato. MicroPython attualmente converte gli interi negativi come con segno, e quelli positivi come senza segno. (Dettagli.)

isinstance(obj: Any, classinfo: type | tuple) → bool#: Restituisce True se obj e un’istanza di classinfo o di una qualsiasi delle sue sottoclassi. classinfo puo essere una classe o una tupla di classi.

issubclass(cls: type, classinfo: type | tuple) → bool#: Restituisce True se cls e una sottoclasse (diretta, indiretta o virtuale) di classinfo.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]#: Restituisce un oggetto iteratore. Con un solo argomento, obj deve supportare il protocollo di iterazione. Con due argomenti, obj deve essere richiamabile e l’iterazione si arresta quando restituisce sentinel.

len(obj: Any) → int#: Restituisce il numero di elementi in un contenitore.

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

Costruisce una nuova lista, opzionalmente popolata con gli elementi di iterable.

append(object: Any) → None#: Aggiunge object alla fine della lista.

clear() → None#: Rimuove tutti gli elementi dalla lista, lasciandola vuota.

copy() → list#: Restituisce una copia superficiale della lista.

count(value: Any) → int#: Restituisce il numero di elementi nella lista che sono uguali a value.

extend(iterable: Iterable[Any]) → None#: Aggiunge tutti gli elementi di iterable alla fine della lista. Se iterable e a sua volta una lista, i suoi elementi vengono copiati direttamente; altrimenti viene iterato.

index(value: Any, start: int = 0, stop: int = -1) → int#: Restituisce l’indice del primo elemento uguale a value, cercando nella slice [start:stop]. Solleva ValueError se value non e presente.

insert(index: int, object: Any) → None#: Inserisce object prima della posizione index. Un index negativo viene interpretato relativamente alla fine della lista, e l’indice viene limitato all’intervallo valido (quindi valori oltre uno dei due estremi inseriscono all’inizio o alla fine).

pop(index: int = -1) → Any#: Rimuove e restituisce l’elemento alla posizione index (l’ultimo elemento per impostazione predefinita). Solleva IndexError se la lista e vuota o index e fuori intervallo.

remove(value: Any) → None#: Rimuove il primo elemento uguale a value. Solleva ValueError se value non e presente.

reverse() → None#: Inverte sul posto l’ordine degli elementi della lista.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None#: Ordina sul posto gli elementi della lista. key e reverse sono solo keyword. key, se fornito, e una funzione applicata a ciascun elemento per produrre il valore di confronto; reverse ordina in ordine decrescente.

Nota
A differenza di CPython, l’ordinamento delle liste in MicroPython non e stabile.

locals() → dict#: Restituisce un dizionario che rappresenta la tabella locale dei simboli corrente.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]#: Restituisce un iteratore che applica function a ogni elemento di iterables, producendo i risultati.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any#: Con un singolo argomento iterabile, restituisce il suo elemento piu grande. Con due o piu argomenti, restituisce l’argomento piu grande.

class memoryview(obj: Any)#: Crea un memoryview che fa riferimento a obj, il quale deve supportare il buffer protocol (ad esempio bytes, bytearray, array.array). Consente l’accesso e lo slicing della memoria sottostante senza copie; lo slicing di un memoryview restituisce un altro memoryview anziche una copia.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any#: Con un singolo argomento iterabile, restituisce il suo elemento piu piccolo. Con due o piu argomenti, restituisce l’argomento piu piccolo.

next(iterator: Iterator[Any], default: Any = None) → Any#: Recupera l’elemento successivo da iterator. Se viene fornito default e l’iteratore e esaurito, viene restituito default anziche sollevare StopIteration.

class object#: Restituisce un nuovo oggetto privo di caratteristiche. object e la classe base di tutte le classi.

oct(x: int) → str#: Converte un intero in una stringa ottale preceduta dal prefisso "0o".

open(file: str, mode: str = 'r', **kwargs) → Any#: Apre file e restituisce il corrispondente oggetto file. mode vale "r" per impostazione predefinita, per la lettura in modalita testo.

ord(c: str) → int#: Restituisce il code point Unicode di una stringa di un solo carattere c come intero.

pow(base: Any, exp: Any, mod: Any | None = None) → Any#: Restituisce base elevato alla potenza exp. Se viene fornito mod, restituisce base ** exp % mod (calcolato in modo piu efficiente rispetto alla forma esplicita).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None#: Stampa objects sullo stream di testo file, separati da sep e seguiti da 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#: Restituisce un attributo property. Tipicamente usato come decoratore per definire attributi gestiti su una classe.

range(*args: int) → range#: Restituisce una sequenza immutabile di interi. Chiamato come range(stop), range(start, stop) o range(start, stop, step).

repr(obj: Any) → str#: Restituisce una stringa contenente una rappresentazione stampabile di obj.

reversed(seq: Any) → Iterator[Any]#: Restituisce un iteratore inverso sui valori della sequenza fornita.

round(number: Any, ndigits: int | None = None) → Any#: Restituisce number arrotondato a ndigits cifre decimali. Se ndigits viene omesso, restituisce l’intero piu vicino.

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

Restituisce un nuovo oggetto set, opzionalmente con elementi presi da iterable.

add(elem: Any) → None#: Aggiunge l’elemento elem al set.

clear() → None#: Rimuove tutti gli elementi dal set.

copy() → set#: Restituisce una copia superficiale del set.

difference(*others: Iterable[Any]) → set#: Restituisce un nuovo set con gli elementi del set che non sono presenti in nessuno di others. Ogni argomento puo essere un qualsiasi iterabile.

difference_update(*others: Iterable[Any]) → None#: Rimuove dal set tutti gli elementi presenti in uno qualsiasi di others (sul posto).

discard(elem: Any) → None#: Rimuove l’elemento elem dal set se e presente. A differenza di remove(), questo non solleva un errore se elem e assente.

intersection(other: Iterable[Any]) → set#: Restituisce un nuovo set con gli elementi comuni al set e a other. In MicroPython viene accettato un solo argomento other (CPython ne accetta piu di uno).

intersection_update(other: Iterable[Any]) → None#: Aggiorna il set, mantenendo solo gli elementi presenti anche in other (sul posto). In MicroPython viene accettato un solo argomento other.

isdisjoint(other: Iterable[Any]) → bool#: Restituisce True se il set non ha elementi in comune con other.

issubset(other: Iterable[Any]) → bool#: Restituisce True se ogni elemento del set e presente in other.

issuperset(other: Iterable[Any]) → bool#: Restituisce True se ogni elemento di other e presente nel set.

pop() → Any#: Rimuove e restituisce un elemento arbitrario dal set. Solleva KeyError se il set e vuoto.

remove(elem: Any) → None#: Rimuove l’elemento elem dal set. Solleva KeyError se elem non e contenuto nel set.

symmetric_difference(other: Iterable[Any]) → set#: Restituisce un nuovo set con gli elementi presenti nel set o in other ma non in entrambi. In MicroPython viene accettato un solo argomento other.

symmetric_difference_update(other: Iterable[Any]) → None#: Aggiorna il set, mantenendo solo gli elementi presenti nel set o in other ma non in entrambi (sul posto). In MicroPython viene accettato un solo argomento other.

union(other: Iterable[Any]) → set#: Restituisce un nuovo set con gli elementi del set e di other. In MicroPython viene accettato un solo argomento other (CPython ne accetta piu di uno).

update(*others: Iterable[Any]) → None#: Aggiorna il set, aggiungendo gli elementi da tutti gli others (sul posto).

setattr(obj: Any, name: str, value: Any) → None#: Imposta l’attributo indicato di obj a value. La controparte di getattr().

class slice#: Il builtin slice e il tipo che hanno gli oggetti slice.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list#: Restituisce una nuova lista ordinata a partire dagli elementi di iterable.

staticmethod(func: Callable[..., Any]) → staticmethod#: Trasforma un metodo in un metodo statico. Tipicamente usato come decoratore.

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

Restituisce una versione stringa di object. Se object e un oggetto di tipo bytes, gli argomenti encoding e errors controllano la decodifica.

center(width: int) → str#: Restituisce una copia della stringa centrata in un campo di lunghezza width, riempita con spazi. In MicroPython viene usato solo lo spazio come carattere di riempimento (non c’e un argomento per il carattere di riempimento), e la stringa originale viene restituita invariata quando width non e maggiore della sua lunghezza.

count(sub: str, start: int = 0, end: int = -1) → int#: Restituisce il numero di occorrenze non sovrapposte di sub nella slice [start:end]. Un sub vuoto conta ogni spazio tra i caratteri.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes#: Restituisce un oggetto bytes che codifica la stringa. MicroPython di fatto ignora gli argomenti e usa UTF-8; errors viene accettato ma non ha effetto. Equivalente a bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool#: Restituisce True se la stringa termina con il suffix indicato, che puo essere una singola stringa o una tupla di stringhe da provare. Gli argomenti opzionali start ed end limitano il confronto alla slice [start:end].

find(sub: str, start: int = 0, end: int = -1) → int#: Restituisce l’indice piu basso nella stringa in cui la sottostringa sub viene trovata all’interno della slice [start:end], oppure -1 se non viene trovata.

format(*args: Any, **kwargs: Any) → str#: Esegue un’operazione di formattazione di stringa, sostituendo i campi di sostituzione delimitati dalle parentesi graffe {} con i valori di args e kwargs. Supporta il mini-linguaggio standard di specifica del formato.

index(sub: str, start: int = 0, end: int = -1) → int#: Come find(), ma solleva ValueError quando la sottostringa sub non viene trovata nella slice [start:end].

isalpha() → bool#: Restituisce True se tutti i caratteri della stringa sono alfabetici e la stringa non e vuota, altrimenti False.

isdigit() → bool#: Restituisce True se tutti i caratteri della stringa sono cifre e la stringa non e vuota, altrimenti False.

islower() → bool#: Restituisce True se la stringa contiene almeno un carattere alfabetico e tutti questi caratteri sono minuscoli, altrimenti False.

isspace() → bool#: Restituisce True se tutti i caratteri della stringa sono spazi bianchi e la stringa non e vuota, altrimenti False.

isupper() → bool#: Restituisce True se la stringa contiene almeno un carattere alfabetico e tutti questi caratteri sono maiuscoli, altrimenti False.

join(iterable: Iterable[str]) → str#: Concatena le stringhe di iterable, inserendo questa stringa come separatore tra gli elementi. Gli elementi devono essere stringhe, altrimenti viene sollevata TypeError.

lower() → str#: Restituisce una copia della stringa con tutti i caratteri convertiti in minuscolo.

lstrip(chars: str | None = None) → str#: Restituisce una copia della stringa con i caratteri iniziali rimossi. Se chars viene omesso o e None, vengono rimossi gli spazi bianchi; altrimenti chars viene trattato come un insieme di caratteri da rimuovere.

partition(sep: str) → tuple#: Divide la stringa alla prima occorrenza di sep e restituisce una tupla di 3 elementi (head, sep, tail). Se sep non viene trovato, restituisce (self, "", ""). Un sep vuoto solleva ValueError.

replace(old: str, new: str, count: int = -1) → str#: Restituisce una copia della stringa con tutte le occorrenze della sottostringa old sostituite da new. Se viene fornito count ed e non negativo, vengono sostituite solo le prime count occorrenze.

rfind(sub: str, start: int = 0, end: int = -1) → int#: Restituisce l’indice piu alto nella stringa in cui la sottostringa sub viene trovata all’interno della slice [start:end], oppure -1 se non viene trovata.

rindex(sub: str, start: int = 0, end: int = -1) → int#: Come rfind(), ma solleva ValueError quando la sottostringa sub non viene trovata nella slice [start:end].

rpartition(sep: str) → tuple#: Divide la stringa all’ultima occorrenza di sep e restituisce una tupla di 3 elementi (head, sep, tail). Se sep non viene trovato, restituisce ("", "", self). Un sep vuoto solleva ValueError.

rsplit(sep: str | None = None, maxsplit: int = -1) → list#: Divide la stringa da destra in una lista di sottostringhe usando sep come delimitatore, eseguendo al massimo maxsplit divisioni. Senza maxsplit (o con uno negativo) si comporta in modo identico a split(); in MicroPython rsplit(None, n) con un n non negativo solleva NotImplementedError.

rstrip(chars: str | None = None) → str#: Restituisce una copia della stringa con i caratteri finali rimossi. Se chars viene omesso o e None, vengono rimossi gli spazi bianchi; altrimenti chars viene trattato come un insieme di caratteri da rimuovere.

split(sep: str | None = None, maxsplit: int = -1) → list#: Divide la stringa in una lista di sottostringhe usando sep come delimitatore, eseguendo al massimo maxsplit divisioni. Se sep viene omesso o e None, divide alle sequenze di spazi bianchi ignorando gli spazi bianchi iniziali; altrimenti un sep vuoto solleva ValueError.

splitlines(keepends: bool = False) → list#: Restituisce una lista delle righe della stringa, suddividendo a \n, \r e \r\n. Le interruzioni di riga non sono incluse a meno che keepends non sia vero.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool#: Restituisce True se la stringa inizia con il prefix indicato, che puo essere una singola stringa o una tupla di stringhe da provare. Gli argomenti opzionali start ed end limitano il confronto alla slice [start:end].

strip(chars: str | None = None) → str#: Restituisce una copia della stringa con i caratteri iniziali e finali rimossi. Se chars viene omesso o e None, vengono rimossi gli spazi bianchi; altrimenti chars viene trattato come un insieme di caratteri da rimuovere.

upper() → str#: Restituisce una copia della stringa con tutti i caratteri convertiti in maiuscolo.

sum(iterable: Iterable[Any], start: Any = 0) → Any#: Somma start e gli elementi di iterable da sinistra a destra, e restituisce il totale.

super(type: type | None = None, obj_or_type: Any | None = None) → Any#: Restituisce un oggetto proxy che delega le chiamate ai metodi a una classe genitore o sorella di type. Utile per accedere a metodi ereditati che sono stati ridefiniti in una classe.

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

Costruisce una nuova tupla, opzionalmente popolata con gli elementi di iterable. Le tuple sono sequenze immutabili.

count(value: Any) → int#: Restituisce il numero di elementi nella tupla che sono uguali a value.

index(value: Any, start: int = 0, stop: int = -1) → int#: Restituisce l’indice del primo elemento uguale a value, cercando nella slice [start:stop]. Solleva ValueError se value non e presente.

type(obj: Any) → type#: Con un argomento, restituisce il tipo di obj. Il valore restituito e un oggetto tipo.

zip(*iterables: Iterable[Any]) → Iterator[tuple]#: Restituisce un iteratore di tuple, dove la i-esima tupla contiene l”i-esimo elemento di ciascuno degli iterabili passati come argomenti. L’iterazione si arresta quando l’iterabile di input piu corto e esaurito.

Eccezioni#

exception AssertionError#: Sollevata quando un’istruzione assert fallisce.

exception AttributeError#: Sollevata quando un riferimento o un’assegnazione a un attributo fallisce.

exception Exception#: Classe base comune per tutte le eccezioni che non causano l’uscita dal sistema.

exception ImportError#: Sollevata quando un’istruzione import non riesce a trovare la definizione del modulo.

exception IndexError#: Sollevata quando un indice di sequenza e fuori intervallo.

exception KeyboardInterrupt#

Sollevata quando l’utente interrompe l’esecuzione del programma, di solito premendo Ctrl+C sul REPL.

Vedi anche nel contesto di Soft bricking (mancato avvio).

exception KeyError#: Sollevata quando la chiave di una mappatura (dizionario) non viene trovata nell’insieme delle chiavi esistenti.

exception MemoryError#: Sollevata quando un’operazione esaurisce la memoria.

exception NameError#: Sollevata quando un nome locale o globale non viene trovato.

exception NotImplementedError#: Sollevata quando viene invocato un metodo astratto o una funzionalita non implementata.

exception OSError#: Sollevata quando una funzione di sistema restituisce un errore relativo al sistema.

exception RuntimeError#: Sollevata quando viene rilevato un errore che non rientra in nessuna delle altre categorie.

exception StopIteration#: Sollevata da next() e dal metodo __next__() di un iteratore per segnalare che non ci sono altri elementi.

exception SyntaxError#: Sollevata quando il parser incontra un errore di sintassi.

exception SystemExit#

Sollevata da sys.exit() per richiedere la terminazione dell’interprete. A differenza della maggior parte delle eccezioni, non produce un traceback quando non viene catturata.

Sulla OpenMV Cam, un SystemExit non gestito attualmente provoca un Soft reset di MicroPython.

exception TypeError#: Sollevata quando un’operazione o una funzione viene applicata a un oggetto di tipo inappropriato.

exception ValueError#: Sollevata quando un’operazione o una funzione builtin riceve un argomento del tipo corretto ma con un valore inappropriato.

exception ZeroDivisionError#: Sollevata quando il secondo argomento di un’operazione di divisione o di modulo e zero.

builtins — funzioni ed eccezioni builtin#

Funzioni e tipi#

Eccezioni#

`builtins` — funzioni ed eccezioni builtin#