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.