`builtins` — fonctions et exceptions intégrées¶

Toutes les fonctions et exceptions intégrées sont décrites ici. Elles sont également disponibles via le module builtins.

Fonctions et types¶

abs(x: Any) → Any¶: Renvoie la valeur absolue d’un nombre. L’argument peut être un entier, un flottant ou tout objet implémentant __abs__().

all(iterable: Iterable[Any]) → bool¶: Renvoie True si tous les éléments de iterable sont vrais (ou si l’itérable est vide).

any(iterable: Iterable[Any]) → bool¶: Renvoie True si au moins un élément de iterable est vrai. Renvoie False si l’itérable est vide.

bin(x: int) → str¶: Convertit un entier en une chaîne binaire préfixée par "0b". L’argument doit être un entier Python ou implémenter __index__().

class bool(x: Any = False)¶: Renvoie une valeur booléenne, c’est-à-dire True ou False. x est converti à l’aide de la procédure standard de test de vérité.

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

Séquence mutable d’entiers compris entre 0 et 255. La construction suit les mêmes règles que bytes : à partir d’un entier (créant un tampon de cette taille rempli de zéros), d’un itérable d’entiers, d’une chaîne avec encoding, ou de tout objet respectant le protocole tampon. Prend en charge les opérations de séquence standard ainsi que la modification sur place.

classmethod fromhex(string: str) → bytearray¶: Construit un bytearray à partir d’une chaîne de paires de chiffres hexadécimaux. Les espaces entre les paires de chiffres sont ignorés ; un caractère non hexadécimal déclenche ValueError.

append(val: int) → None¶: Ajoute une seule valeur (un entier compris entre 0 et 255) à la fin du bytearray, l’agrandissant d’un octet.

center(width: int, fillbyte: bytes) → bytes¶: Renvoie une copie du contenu centré dans une séquence de longueur width, complétée par fillbyte. Contrairement à CPython, fillbyte est obligatoire. Les données sont renvoyées inchangées lorsque width n’est pas supérieur à la longueur actuelle.

count(sub: bytes, start: int = 0, end: int = -1) → int¶: Renvoie le nombre d’occurrences non chevauchantes de sub dans la tranche [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool¶: Renvoie True si le contenu se termine par suffix. Contrairement à CPython, suffix ne peut pas être un tuple de valeurs.

extend(iterable: Iterable[int]) → None¶: Ajoute tous les éléments de iterable à la fin du bytearray. En tant qu’extension de CPython, tout objet prenant en charge le protocole tampon peut être utilisé.

find(sub: bytes, start: int = 0, end: int = -1) → int¶: Renvoie l’indice le plus bas où sub est trouvé dans la tranche [start:end], ou -1 s’il n’est pas trouvé.

format(*args: Any, **kwargs: Any) → str¶: Effectue une opération de formatage de chaîne en utilisant le contenu comme chaîne de format, et renvoie le résultat formaté.

hex(sep: str = '') → str¶: Renvoie une chaîne de deux chiffres hexadécimaux pour chaque octet. Si l’argument optionnel sep (une chaîne de longueur 1) est fourni, il est inséré entre les valeurs d’octets consécutives.

index(sub: bytes, start: int = 0, end: int = -1) → int¶: Comme find(), mais déclenche ValueError lorsque sub n’est pas trouvé.

isalpha() → bool¶: Renvoie True si tous les octets sont des caractères ASCII alphabétiques et qu’il y a au moins un octet, sinon False.

isdigit() → bool¶: Renvoie True si tous les octets sont des chiffres décimaux ASCII et qu’il y a au moins un octet, sinon False.

islower() → bool¶: Renvoie True si tous les octets ayant une casse sont en minuscules et qu’il y a au moins un octet ayant une casse, sinon False.

isspace() → bool¶: Renvoie True si tous les octets sont des espaces ASCII et qu’il y a au moins un octet, sinon False.

isupper() → bool¶: Renvoie True si tous les octets ayant une casse sont en majuscules et qu’il y a au moins un octet ayant une casse, sinon False.

join(iterable: Iterable[bytes]) → bytes¶: Renvoie un objet bytes qui est la concaténation des éléments de iterable, en utilisant le contenu du bytearray comme séparateur.

lower() → bytes¶: Renvoie une copie du contenu avec tous les caractères ASCII majuscules convertis en minuscules.

lstrip(chars: bytes | None = None) → bytes¶: Renvoie une copie dont les octets de début sont supprimés. chars spécifie l’ensemble des octets à supprimer ; s’il est omis ou None, les espaces ASCII sont supprimés.

partition(sep: bytes) → tuple¶: Sépare à la première occurrence de sep, en renvoyant (head, sep, tail). Si sep n’est pas trouvé, renvoie le contenu suivi de deux objets vides.

replace(old: bytes, new: bytes, count: int = -1) → bytes¶: Renvoie une copie où toutes les occurrences de old sont remplacées par new. Si count est fourni, seules les count premières occurrences sont remplacées.

rfind(sub: bytes, start: int = 0, end: int = -1) → int¶: Renvoie l’indice le plus élevé où sub est trouvé dans la tranche [start:end], ou -1 s’il n’est pas trouvé.

rindex(sub: bytes, start: int = 0, end: int = -1) → int¶: Comme rfind(), mais déclenche ValueError lorsque sub n’est pas trouvé.

rpartition(sep: bytes) → tuple¶: Sépare à la dernière occurrence de sep, en renvoyant (head, sep, tail). Si sep n’est pas trouvé, renvoie deux objets vides suivis du contenu.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list¶: Sépare aux occurrences de sep en une liste de morceaux, en effectuant au plus maxsplit séparations comptées depuis la droite. Si sep est None ou omis, sépare sur des suites d’espaces ASCII.

rstrip(chars: bytes | None = None) → bytes¶: Renvoie une copie dont les octets de fin sont supprimés. chars spécifie l’ensemble des octets à supprimer ; s’il est omis ou None, les espaces ASCII sont supprimés.

split(sep: bytes | None = None, maxsplit: int = -1) → list¶: Sépare aux occurrences de sep en une liste de morceaux. Si sep est None ou omis, sépare sur des suites d’espaces ASCII et les espaces de début et de fin sont ignorés.

splitlines(keepends: bool = False) → list¶: Renvoie une liste des lignes, en coupant à \n, \r et \r\n. Les sauts de ligne sont exclus sauf si keepends est vrai.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool¶: Renvoie True si le contenu commence par prefix. Contrairement à CPython, prefix ne peut pas être un tuple, et end est accepté mais ignoré.

strip(chars: bytes | None = None) → bytes¶: Renvoie une copie dont les octets de début et de fin sont supprimés. chars spécifie l’ensemble des octets à supprimer ; s’il est omis ou None, les espaces ASCII sont supprimés.

upper() → bytes¶: Renvoie une copie du contenu avec tous les caractères ASCII minuscules convertis en majuscules.

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

Séquence immuable d’entiers compris entre 0 et 255. Créée à partir d’un entier (tampon rempli de zéros), d’un itérable d’entiers, d’une chaîne avec encoding, ou de tout objet respectant le protocole tampon. Les littéraux bytes utilisent la syntaxe b'...'.

classmethod fromhex(string: str) → bytes¶: Construit un objet bytes à partir d’une chaîne de paires de chiffres hexadécimaux. Les espaces entre les paires de chiffres sont ignorés ; un caractère non hexadécimal déclenche ValueError.

center(width: int, fillbyte: bytes) → bytes¶: Renvoie une copie centrée dans une séquence de longueur width, complétée par fillbyte (un bytes de longueur 1 donnant l’octet de remplissage). Contrairement à CPython, fillbyte est obligatoire. L’objet d’origine est renvoyé inchangé lorsque width n’est pas supérieur à sa longueur.

count(sub: bytes, start: int = 0, end: int = -1) → int¶: Renvoie le nombre d’occurrences non chevauchantes de sub dans la tranche [start:end].

decode(encoding: str = 'utf-8') → str¶: Renvoie une str décodée à partir des octets. Dans MicroPython, l’argument encoding est accepté mais effectivement ignoré (les octets sont réinterprétés en UTF-8).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool¶: Renvoie True si les octets se terminent par suffix. Contrairement à CPython, suffix ne peut pas être un tuple de valeurs à essayer.

find(sub: bytes, start: int = 0, end: int = -1) → int¶: Renvoie l’indice le plus bas où la sous-séquence sub est trouvée dans la tranche [start:end], ou -1 si elle n’est pas trouvée.

format(*args: Any, **kwargs: Any) → str¶: Effectue une opération de formatage de chaîne en utilisant les octets comme chaîne de format, et renvoie le résultat formaté.

hex(sep: str = '') → str¶: Renvoie une chaîne de deux chiffres hexadécimaux pour chaque octet. Si l’argument optionnel sep (une chaîne de longueur 1) est fourni, il est inséré entre les valeurs d’octets consécutives.

index(sub: bytes, start: int = 0, end: int = -1) → int¶: Comme find(), mais déclenche ValueError lorsque sub n’est pas trouvé.

isalpha() → bool¶: Renvoie True si tous les octets sont des caractères ASCII alphabétiques et qu’il y a au moins un octet, sinon False.

isdigit() → bool¶: Renvoie True si tous les octets sont des chiffres décimaux ASCII et qu’il y a au moins un octet, sinon False.

islower() → bool¶: Renvoie True si tous les octets ayant une casse sont en minuscules et qu’il y a au moins un octet ayant une casse, sinon False.

isspace() → bool¶: Renvoie True si tous les octets sont des espaces ASCII et qu’il y a au moins un octet, sinon False.

isupper() → bool¶: Renvoie True si tous les octets ayant une casse sont en majuscules et qu’il y a au moins un octet ayant une casse, sinon False.

join(iterable: Iterable[bytes]) → bytes¶: Renvoie un objet bytes qui est la concaténation des éléments de iterable, en utilisant l’objet bytes lui-même comme séparateur.

lower() → bytes¶: Renvoie une copie avec tous les caractères ASCII majuscules convertis en minuscules.

lstrip(chars: bytes | None = None) → bytes¶: Renvoie une copie dont les octets de début sont supprimés. chars spécifie l’ensemble des octets à supprimer ; s’il est omis ou None, les espaces ASCII sont supprimés.

partition(sep: bytes) → tuple¶: Sépare à la première occurrence de sep, en renvoyant (head, sep, tail). Si sep n’est pas trouvé, renvoie les octets suivis de deux objets bytes vides.

replace(old: bytes, new: bytes, count: int = -1) → bytes¶: Renvoie une copie où toutes les occurrences de old sont remplacées par new. Si count est fourni, seules les count premières occurrences sont remplacées.

rfind(sub: bytes, start: int = 0, end: int = -1) → int¶: Renvoie l’indice le plus élevé où sub est trouvé dans la tranche [start:end], ou -1 s’il n’est pas trouvé.

rindex(sub: bytes, start: int = 0, end: int = -1) → int¶: Comme rfind(), mais déclenche ValueError lorsque sub n’est pas trouvé.

rpartition(sep: bytes) → tuple¶: Sépare à la dernière occurrence de sep, en renvoyant (head, sep, tail). Si sep n’est pas trouvé, renvoie deux objets bytes vides suivis des octets.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list¶: Sépare aux occurrences de sep en une liste de morceaux, en effectuant au plus maxsplit séparations comptées depuis la droite. Si sep est None ou omis, sépare sur des suites d’espaces ASCII.

rstrip(chars: bytes | None = None) → bytes¶: Renvoie une copie dont les octets de fin sont supprimés. chars spécifie l’ensemble des octets à supprimer ; s’il est omis ou None, les espaces ASCII sont supprimés.

split(sep: bytes | None = None, maxsplit: int = -1) → list¶: Sépare aux occurrences de sep en une liste de morceaux. Si sep est None ou omis, sépare sur des suites d’espaces ASCII et les espaces de début et de fin sont ignorés.

splitlines(keepends: bool = False) → list¶: Renvoie une liste des lignes, en coupant à \n, \r et \r\n. Les sauts de ligne sont exclus sauf si keepends est vrai.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool¶: Renvoie True si les octets commencent par prefix. Contrairement à CPython, prefix ne peut pas être un tuple, et end est accepté mais ignoré.

strip(chars: bytes | None = None) → bytes¶: Renvoie une copie dont les octets de début et de fin sont supprimés. chars spécifie l’ensemble des octets à supprimer ; s’il est omis ou None, les espaces ASCII sont supprimés.

upper() → bytes¶: Renvoie une copie avec tous les caractères ASCII minuscules convertis en majuscules.

callable(obj: Any) → bool¶: Renvoie True si obj semble appelable, False sinon.

chr(i: int) → str¶: Renvoie une chaîne d’un seul caractère dont le point de code Unicode est l’entier i.

classmethod(func: Callable[..., Any]) → classmethod¶: Transforme une méthode en méthode de classe. Généralement utilisé comme décorateur.

compile(source: str | bytes, filename: str, mode: str) → Any¶: Compile source en un objet code qui peut être exécuté par exec() ou eval(). mode est l’un de "exec", "eval" ou "single".

class complex(real: float | str = 0, imag: float = 0)¶: Crée un nombre complexe à partir d’une partie réelle et d’une partie imaginaire, ou à partir d’une chaîne.

delattr(obj, name: str) → None¶: L’argument name doit être une chaîne, et cette fonction supprime l’attribut nommé de l’objet donné par obj.

class dict(*args, **kwargs)¶

Crée un nouveau dictionnaire. Équivalent à dict de CPython.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict¶: Crée un nouveau dictionnaire avec des clés issues de iterable, chacune associée à value (None par défaut). Appelé sur le type, par exemple dict.fromkeys(...).

clear() → None¶: Supprime tous les éléments du dictionnaire, le laissant vide. Déclenche TypeError si le dictionnaire est fixe (en lecture seule).

copy() → dict¶: Renvoie une copie superficielle du dictionnaire. L’objet renvoyé a le même type que l’original (dict ou OrderedDict) mais n’est pas fixe.

get(key: Any, default: Any = None) → Any¶: Renvoie la valeur associée à key si elle est dans le dictionnaire, sinon renvoie default (qui vaut lui-même None par défaut, de sorte que cela ne déclenche jamais KeyError). Le dictionnaire n’est pas modifié.

items() → Any¶: Renvoie un objet vue dynamique sur les paires (key, value) qui reflète les modifications ultérieures du dictionnaire et prend en charge l’itération, len(), l’opérateur in et les opérateurs de comparaison d’ensembles.

keys() → Any¶: Renvoie un objet vue dynamique sur les clés qui reflète les modifications ultérieures du dictionnaire et prend en charge l’itération, len(), l’opérateur in et les opérateurs de comparaison d’ensembles.

pop(key: Any, default: Any = None) → Any¶: Supprime key du dictionnaire et renvoie sa valeur. Si key n’est pas présente, renvoie default s’il a été fourni ; sinon déclenche KeyError. Déclenche TypeError si le dictionnaire est fixe.

popitem() → tuple¶: Supprime et renvoie une paire (key, value) arbitraire sous forme de 2-tuple. Pour un simple dict, la paire choisie n’est pas spécifiée ; pour un OrderedDict, la dernière paire insérée est supprimée (LIFO). Déclenche KeyError si le dictionnaire est vide, ou TypeError s’il est fixe.

setdefault(key: Any, default: Any = None) → Any¶: Si key est dans le dictionnaire, renvoie sa valeur. Sinon, insère key avec la valeur default (None par défaut) et renvoie cette valeur. Déclenche TypeError si le dictionnaire est fixe.

update(*args: Any, **kwargs: Any) → None¶: Met à jour le dictionnaire sur place. Au plus un argument positionnel est accepté : soit un autre dictionnaire, soit un itérable de paires (key, value) à deux éléments (chacune doit produire exactement deux éléments, sinon ValueError est déclenchée). Les arguments nommés sont ensuite ajoutés en tant qu’entrées à clé chaîne. Les clés existantes sont écrasées. Déclenche TypeError si le dictionnaire est fixe.

values() → Any¶: Renvoie un objet vue dynamique sur les valeurs qui reflète les modifications ultérieures du dictionnaire et prend en charge l’itération et len().

__getitem__(key: Any) → Any¶: Renvoie self[key]. Implémente l’opérateur d’indexation d[key] ; déclenche KeyError si key n’est pas présente.

__setitem__(key: Any, value: Any) → None¶: Affecte value à self[key]. Implémente d[key] = value.

__delitem__(key: Any) → None¶: Supprime self[key]. Implémente del d[key] ; déclenche KeyError si key n’est pas présente.

dir(obj: Any = None) → list¶: Sans arguments, renvoie la liste des noms dans la portée locale actuelle. Avec un argument, renvoie une liste des attributs valides pour cet objet.

divmod(a: Any, b: Any) → tuple¶: Renvoie la paire (a // b, a % b) sous forme de tuple, pour deux nombres (non complexes).

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]¶: Renvoie un objet enumerate produisant des paires (index, value) à partir de iterable, l’indice commençant à start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any¶: Évalue une expression Python donnée sous forme de chaîne (ou d’objet code compilé) et renvoie le résultat.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None¶: Exécute dynamiquement du code Python fourni sous forme de chaîne ou d’objet code compilé.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]¶: Construit un itérateur à partir des éléments de iterable pour lesquels function renvoie vrai. Si function est None, la fonction identité est supposée.

class float(x: str | bytes | int | float = 0.0)¶: Renvoie un nombre à virgule flottante construit à partir d’un nombre ou d’une chaîne x.

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

Renvoie un nouvel objet frozenset, éventuellement avec des éléments issus de iterable. frozenset est une variante immuable et hachable de set.

copy() → frozenset¶: Renvoie une copie superficielle du frozenset.

difference(*others: Iterable[Any]) → frozenset¶: Renvoie un nouveau frozenset contenant les éléments du frozenset qui ne sont dans aucun des others. Chaque argument peut être n’importe quel itérable.

intersection(other: Iterable[Any]) → frozenset¶: Renvoie un nouveau frozenset contenant les éléments communs au frozenset et à other. Dans MicroPython, un seul argument other est accepté (CPython en accepte plusieurs).

isdisjoint(other: Iterable[Any]) → bool¶: Renvoie True si le frozenset n’a aucun élément en commun avec other.

issubset(other: Iterable[Any]) → bool¶: Renvoie True si chaque élément du frozenset est dans other.

issuperset(other: Iterable[Any]) → bool¶: Renvoie True si chaque élément de other est dans le frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset¶: Renvoie un nouveau frozenset contenant les éléments présents dans le frozenset ou dans other mais pas dans les deux. Dans MicroPython, un seul argument other est accepté.

union(other: Iterable[Any]) → frozenset¶: Renvoie un nouveau frozenset contenant les éléments du frozenset et de other. Dans MicroPython, un seul argument other est accepté (CPython en accepte plusieurs).

getattr(obj: Any, name: str, default: Any = None) → Any¶: Renvoie la valeur de l’attribut nommé de obj. Si l’attribut n’existe pas, default est renvoyé s’il est fourni, sinon AttributeError est déclenchée.

globals() → dict¶: Renvoie un dictionnaire représentant la table des symboles globaux du module actuel.

hasattr(obj: Any, name: str) → bool¶: Renvoie True si obj possède un attribut portant le nom name donné, False sinon.

hash(obj: Any) → int¶: Renvoie la valeur de hachage de obj (s’il en a une). Les valeurs de hachage sont des entiers utilisés pour comparer rapidement les clés d’un dictionnaire lors d’une recherche dans celui-ci.

hex(x: int) → str¶: Convertit un entier en une chaîne hexadécimale en minuscules préfixée par "0x".

id(obj: Any) → int¶: Renvoie l’identité d’un objet. Il s’agit d’un entier dont l’unicité et la constance sont garanties pour cet objet pendant toute sa durée de vie.

input(prompt: str = '') → str¶: Lit une ligne depuis l’entrée standard et la renvoie sous forme de chaîne (sans saut de ligne final). Si prompt est fourni, il est d’abord écrit sur la sortie standard sans saut de ligne final.

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

classmethod from_bytes(bytes: bytes, byteorder: str) → int¶: Dans MicroPython, le paramètre byteorder doit être positionnel (ceci est compatible avec CPython).

to_bytes(size: int, byteorder: str) → bytes¶: Dans MicroPython, le paramètre byteorder doit être positionnel (ceci est compatible avec CPython).

Note

L’argument nommé optionnel signed de CPython n’est pas pris en charge. MicroPython convertit actuellement les entiers négatifs comme signés, et les positifs comme non signés. (Détails.)

isinstance(obj: Any, classinfo: type | tuple) → bool¶: Renvoie True si obj est une instance de classinfo ou de l’une de ses sous-classes. classinfo peut être une classe ou un tuple de classes.

issubclass(cls: type, classinfo: type | tuple) → bool¶: Renvoie True si cls est une sous-classe (directe, indirecte ou virtuelle) de classinfo.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]¶: Renvoie un objet itérateur. Avec un seul argument, obj doit prendre en charge le protocole d’itération. Avec deux arguments, obj doit être appelable et l’itération s’arrête lorsqu’il renvoie sentinel.

len(obj: Any) → int¶: Renvoie le nombre d’éléments dans un conteneur.

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

Construit une nouvelle liste, éventuellement remplie avec les éléments de iterable.

append(object: Any) → None¶: Ajoute object à la fin de la liste.

clear() → None¶: Supprime tous les éléments de la liste, la laissant vide.

copy() → list¶: Renvoie une copie superficielle de la liste.

count(value: Any) → int¶: Renvoie le nombre d’éléments de la liste égaux à value.

extend(iterable: Iterable[Any]) → None¶: Ajoute tous les éléments de iterable à la fin de la liste. Si iterable est lui-même une liste, ses éléments sont copiés directement ; sinon, il est parcouru.

index(value: Any, start: int = 0, stop: int = -1) → int¶: Renvoie l’indice du premier élément égal à value, en cherchant dans la tranche [start:stop]. Déclenche ValueError si value n’est pas présent.

insert(index: int, object: Any) → None¶: Insère object avant la position index. Un index négatif est interprété relativement à la fin de la liste, et l’indice est limité à la plage valide (de sorte que des valeurs dépassant l’une ou l’autre extrémité insèrent au début ou à la fin).

pop(index: int = -1) → Any¶: Supprime et renvoie l’élément à la position index (le dernier élément par défaut). Déclenche IndexError si la liste est vide ou si index est hors plage.

remove(value: Any) → None¶: Supprime le premier élément égal à value. Déclenche ValueError si value n’est pas présent.

reverse() → None¶: Inverse l’ordre des éléments de la liste sur place.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None¶: Trie les éléments de la liste sur place. key et reverse sont des arguments exclusivement nommés. key, s’il est fourni, est une fonction appliquée à chaque élément pour produire la valeur de comparaison ; reverse trie par ordre décroissant.

Note

Contrairement à CPython, le tri de liste de MicroPython n’est pas stable.

locals() → dict¶: Renvoie un dictionnaire représentant la table des symboles locaux actuelle.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]¶: Renvoie un itérateur qui applique function à chaque élément de iterables, en produisant les résultats.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any¶: Avec un seul argument itérable, renvoie son plus grand élément. Avec deux arguments ou plus, renvoie le plus grand argument.

class memoryview(obj: Any)¶: Crée une memoryview qui référence obj, lequel doit prendre en charge le protocole tampon (par exemple bytes, bytearray, array.array). Permet un accès et un découpage sans copie de la mémoire sous-jacente ; le découpage d’une memoryview renvoie une autre memoryview plutôt qu’une copie.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any¶: Avec un seul argument itérable, renvoie son plus petit élément. Avec deux arguments ou plus, renvoie le plus petit argument.

next(iterator: Iterator[Any], default: Any = None) → Any¶: Récupère l’élément suivant de iterator. Si default est fourni et que l’itérateur est épuisé, default est renvoyé au lieu de déclencher StopIteration.

class object¶: Renvoie un nouvel objet sans caractéristiques. object est la classe de base de toutes les classes.

oct(x: int) → str¶: Convertit un entier en une chaîne octale préfixée par "0o".

open(file: str, mode: str = 'r', **kwargs) → Any¶: Ouvre file et renvoie un objet fichier correspondant. mode vaut "r" par défaut pour la lecture de texte.

ord(c: str) → int¶: Renvoie le point de code Unicode d’une chaîne d’un seul caractère c sous forme d’entier.

pow(base: Any, exp: Any, mod: Any | None = None) → Any¶: Renvoie base élevé à la puissance exp. Si mod est fourni, renvoie base ** exp % mod (calculé plus efficacement que la forme explicite).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None¶: Affiche objects dans le flux de texte file, séparés par sep et suivis 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¶: Renvoie un attribut property. Généralement utilisé comme décorateur pour définir des attributs gérés sur une classe.

range(*args: int) → range¶: Renvoie une séquence immuable d’entiers. Appelé sous la forme range(stop), range(start, stop) ou range(start, stop, step).

repr(obj: Any) → str¶: Renvoie une chaîne contenant une représentation affichable de obj.

reversed(seq: Any) → Iterator[Any]¶: Renvoie un itérateur inverse sur les valeurs de la séquence donnée.

round(number: Any, ndigits: int | None = None) → Any¶: Renvoie number arrondi à ndigits décimales. Si ndigits est omis, renvoie l’entier le plus proche.

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

Renvoie un nouvel objet set, éventuellement avec des éléments issus de iterable.

add(elem: Any) → None¶: Ajoute l’élément elem à l’ensemble.

clear() → None¶: Supprime tous les éléments de l’ensemble.

copy() → set¶: Renvoie une copie superficielle de l’ensemble.

difference(*others: Iterable[Any]) → set¶: Renvoie un nouvel ensemble contenant les éléments de l’ensemble qui ne sont dans aucun des others. Chaque argument peut être n’importe quel itérable.

difference_update(*others: Iterable[Any]) → None¶: Supprime de l’ensemble tous les éléments trouvés dans l’un quelconque des others (sur place).

discard(elem: Any) → None¶: Supprime l’élément elem de l’ensemble s’il est présent. Contrairement à remove(), cela ne déclenche pas d’erreur si elem est absent.

intersection(other: Iterable[Any]) → set¶: Renvoie un nouvel ensemble contenant les éléments communs à l’ensemble et à other. Dans MicroPython, un seul argument other est accepté (CPython en accepte plusieurs).

intersection_update(other: Iterable[Any]) → None¶: Met à jour l’ensemble en ne conservant que les éléments également présents dans other (sur place). Dans MicroPython, un seul argument other est accepté.

isdisjoint(other: Iterable[Any]) → bool¶: Renvoie True si l’ensemble n’a aucun élément en commun avec other.

issubset(other: Iterable[Any]) → bool¶: Renvoie True si chaque élément de l’ensemble est dans other.

issuperset(other: Iterable[Any]) → bool¶: Renvoie True si chaque élément de other est dans l’ensemble.

pop() → Any¶: Supprime et renvoie un élément arbitraire de l’ensemble. Déclenche KeyError si l’ensemble est vide.

remove(elem: Any) → None¶: Supprime l’élément elem de l’ensemble. Déclenche KeyError si elem n’est pas contenu dans l’ensemble.

symmetric_difference(other: Iterable[Any]) → set¶: Renvoie un nouvel ensemble contenant les éléments présents dans l’ensemble ou dans other mais pas dans les deux. Dans MicroPython, un seul argument other est accepté.

symmetric_difference_update(other: Iterable[Any]) → None¶: Met à jour l’ensemble en ne conservant que les éléments présents dans l’ensemble ou dans other mais pas dans les deux (sur place). Dans MicroPython, un seul argument other est accepté.

union(other: Iterable[Any]) → set¶: Renvoie un nouvel ensemble contenant les éléments de l’ensemble et de other. Dans MicroPython, un seul argument other est accepté (CPython en accepte plusieurs).

update(*others: Iterable[Any]) → None¶: Met à jour l’ensemble en ajoutant les éléments de tous les others (sur place).

setattr(obj: Any, name: str, value: Any) → None¶: Affecte la valeur value à l’attribut nommé de obj. Le pendant de getattr().

class slice¶: Le type intégré slice est le type des objets slice.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list¶: Renvoie une nouvelle liste triée à partir des éléments de iterable.

staticmethod(func: Callable[..., Any]) → staticmethod¶: Transforme une méthode en méthode statique. Généralement utilisé comme décorateur.

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

Renvoie une version chaîne de object. Si object est un objet de type bytes, les arguments encoding et errors contrôlent le décodage.

center(width: int) → str¶: Renvoie une copie de la chaîne centrée dans un champ de longueur width, complétée par des espaces. Dans MicroPython, seul un espace est utilisé comme caractère de remplissage (il n’y a pas d’argument de caractère de remplissage), et la chaîne d’origine est renvoyée inchangée lorsque width n’est pas supérieur à sa longueur.

count(sub: str, start: int = 0, end: int = -1) → int¶: Renvoie le nombre d’occurrences non chevauchantes de sub dans la tranche [start:end]. Un sub vide compte chaque espace entre les caractères.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes¶: Renvoie un objet bytes encodant la chaîne. MicroPython ignore effectivement les arguments et utilise UTF-8 ; errors est accepté mais sans effet. Équivalent à bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool¶: Renvoie True si la chaîne se termine par le suffix donné, qui peut être une seule chaîne ou un tuple de chaînes à essayer. Les arguments optionnels start et end restreignent la comparaison à la tranche [start:end].

find(sub: str, start: int = 0, end: int = -1) → int¶: Renvoie l’indice le plus bas dans la chaîne où la sous-chaîne sub est trouvée dans la tranche [start:end], ou -1 si elle n’est pas trouvée.

format(*args: Any, **kwargs: Any) → str¶: Effectue une opération de formatage de chaîne, en substituant les champs de remplacement délimités par des accolades {} par les valeurs de args et kwargs. Prend en charge le mini-langage standard de spécification de format.

index(sub: str, start: int = 0, end: int = -1) → int¶: Comme find(), mais déclenche ValueError lorsque la sous-chaîne sub n’est pas trouvée dans la tranche [start:end].

isalpha() → bool¶: Renvoie True si tous les caractères de la chaîne sont alphabétiques et que la chaîne est non vide, sinon False.

isdigit() → bool¶: Renvoie True si tous les caractères de la chaîne sont des chiffres et que la chaîne est non vide, sinon False.

islower() → bool¶: Renvoie True si la chaîne contient au moins un caractère alphabétique et que tous ces caractères sont en minuscules, sinon False.

isspace() → bool¶: Renvoie True si tous les caractères de la chaîne sont des espaces et que la chaîne est non vide, sinon False.

isupper() → bool¶: Renvoie True si la chaîne contient au moins un caractère alphabétique et que tous ces caractères sont en majuscules, sinon False.

join(iterable: Iterable[str]) → str¶: Concatène les chaînes de iterable, en insérant cette chaîne comme séparateur entre les éléments. Les éléments doivent être des chaînes, sinon TypeError est déclenchée.

lower() → str¶: Renvoie une copie de la chaîne avec tous les caractères convertis en minuscules.

lstrip(chars: str | None = None) → str¶: Renvoie une copie de la chaîne dont les caractères de début sont supprimés. Si chars est omis ou None, les espaces sont supprimés ; sinon, chars est traité comme un ensemble de caractères à supprimer.

partition(sep: str) → tuple¶: Sépare la chaîne à la première occurrence de sep et renvoie un 3-tuple (head, sep, tail). Si sep n’est pas trouvé, renvoie (self, "", ""). Un sep vide déclenche ValueError.

replace(old: str, new: str, count: int = -1) → str¶: Renvoie une copie de la chaîne où toutes les occurrences de la sous-chaîne old sont remplacées par new. Si count est fourni et non négatif, seules les count premières occurrences sont remplacées.

rfind(sub: str, start: int = 0, end: int = -1) → int¶: Renvoie l’indice le plus élevé dans la chaîne où la sous-chaîne sub est trouvée dans la tranche [start:end], ou -1 si elle n’est pas trouvée.

rindex(sub: str, start: int = 0, end: int = -1) → int¶: Comme rfind(), mais déclenche ValueError lorsque la sous-chaîne sub n’est pas trouvée dans la tranche [start:end].

rpartition(sep: str) → tuple¶: Sépare la chaîne à la dernière occurrence de sep et renvoie un 3-tuple (head, sep, tail). Si sep n’est pas trouvé, renvoie ("", "", self). Un sep vide déclenche ValueError.

rsplit(sep: str | None = None, maxsplit: int = -1) → list¶: Sépare la chaîne en partant de la droite en une liste de sous-chaînes en utilisant sep comme délimiteur, en effectuant au plus maxsplit séparations. Sans maxsplit (ou avec une valeur négative), elle se comporte de façon identique à split() ; dans MicroPython, rsplit(None, n) avec un n non négatif déclenche NotImplementedError.

rstrip(chars: str | None = None) → str¶: Renvoie une copie de la chaîne dont les caractères de fin sont supprimés. Si chars est omis ou None, les espaces sont supprimés ; sinon, chars est traité comme un ensemble de caractères à supprimer.

split(sep: str | None = None, maxsplit: int = -1) → list¶: Sépare la chaîne en une liste de sous-chaînes en utilisant sep comme délimiteur, en effectuant au plus maxsplit séparations. Si sep est omis ou None, sépare sur des suites d’espaces avec les espaces de début ignorés ; sinon, un sep vide déclenche ValueError.

splitlines(keepends: bool = False) → list¶: Renvoie une liste des lignes de la chaîne, en coupant à \n, \r et \r\n. Les sauts de ligne ne sont pas inclus sauf si keepends est vrai.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool¶: Renvoie True si la chaîne commence par le prefix donné, qui peut être une seule chaîne ou un tuple de chaînes à essayer. Les arguments optionnels start et end restreignent la comparaison à la tranche [start:end].

strip(chars: str | None = None) → str¶: Renvoie une copie de la chaîne dont les caractères de début et de fin sont supprimés. Si chars est omis ou None, les espaces sont supprimés ; sinon, chars est traité comme un ensemble de caractères à supprimer.

upper() → str¶: Renvoie une copie de la chaîne avec tous les caractères convertis en majuscules.

sum(iterable: Iterable[Any], start: Any = 0) → Any¶: Additionne start et les éléments de iterable de gauche à droite, et renvoie le total.

super(type: type | None = None, obj_or_type: Any | None = None) → Any¶: Renvoie un objet proxy qui délègue les appels de méthode à une classe parente ou sœur de type. Utile pour accéder aux méthodes héritées qui ont été redéfinies dans une classe.

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

Construit un nouveau tuple, éventuellement rempli avec les éléments de iterable. Les tuples sont des séquences immuables.

count(value: Any) → int¶: Renvoie le nombre d’éléments du tuple égaux à value.

index(value: Any, start: int = 0, stop: int = -1) → int¶: Renvoie l’indice du premier élément égal à value, en cherchant dans la tranche [start:stop]. Déclenche ValueError si value n’est pas présent.

type(obj: Any) → type¶: Avec un seul argument, renvoie le type de obj. La valeur renvoyée est un objet type.

zip(*iterables: Iterable[Any]) → Iterator[tuple]¶: Renvoie un itérateur de tuples, où le i-ième tuple contient le i-ième élément de chacun des itérables fournis en argument. L’itération s’arrête lorsque le plus court des itérables d’entrée est épuisé.

Exceptions¶

exception AssertionError¶: Déclenchée lorsqu’une instruction assert échoue.

exception AttributeError¶: Déclenchée lorsqu’une référence ou une affectation d’attribut échoue.

exception Exception¶: Classe de base commune à toutes les exceptions qui ne provoquent pas la sortie du système.

exception ImportError¶: Déclenchée lorsqu’une instruction import ne parvient pas à trouver la définition du module.

exception IndexError¶: Déclenchée lorsqu’un indice de séquence est hors plage.

exception KeyboardInterrupt¶

Déclenchée lorsque l’utilisateur interrompt l’exécution du programme, généralement en appuyant sur Ctrl+C dans le REPL.

Voir aussi dans le contexte de Soft Bricking (échec du démarrage).

exception KeyError¶: Déclenchée lorsqu’une clé de correspondance (dictionnaire) n’est pas trouvée dans l’ensemble des clés existantes.

exception MemoryError¶: Déclenchée lorsqu’une opération manque de mémoire.

exception NameError¶: Déclenchée lorsqu’un nom local ou global n’est pas trouvé.

exception NotImplementedError¶: Déclenchée lorsqu’une méthode abstraite ou une fonctionnalité non implémentée est invoquée.

exception OSError¶: Déclenchée lorsqu’une fonction système renvoie une erreur liée au système.

exception RuntimeError¶: Déclenchée lorsqu’une erreur est détectée qui n’entre dans aucune des autres catégories.

exception StopIteration¶: Déclenchée par next() et par la méthode __next__() d’un itérateur pour signaler qu’il n’y a plus d’éléments.

exception SyntaxError¶: Déclenchée lorsque l’analyseur rencontre une erreur de syntaxe.

exception SystemExit¶

Déclenchée par sys.exit() pour demander l’arrêt de l’interpréteur. Contrairement à la plupart des exceptions, elle ne produit pas de trace lorsqu’elle n’est pas interceptée.

Sur l’OpenMV Cam, un SystemExit non géré provoque actuellement un Réinitialisation logicielle (soft reset) de MicroPython.

exception TypeError¶: Déclenchée lorsqu’une opération ou une fonction est appliquée à un objet d’un type inapproprié.

exception ValueError¶: Déclenchée lorsqu’une opération ou une fonction intégrée reçoit un argument du bon type mais d’une valeur inappropriée.

exception ZeroDivisionError¶: Déclenchée lorsque le second argument d’une opération de division ou de modulo est zéro.

builtins — fonctions et exceptions intégrées¶

Fonctions et types¶

Exceptions¶

`builtins` — fonctions et exceptions intégrées¶