`builtins` — eingebaute Funktionen und Ausnahmen¶

Alle eingebauten Funktionen und Ausnahmen werden hier beschrieben. Sie sind auch über das Modul builtins verfügbar.

Funktionen und Typen¶

abs(x: Any) → Any¶: Gibt den Absolutwert einer Zahl zurück. Das Argument kann eine Ganzzahl, eine Gleitkommazahl oder ein beliebiges Objekt sein, das __abs__() implementiert.

all(iterable: Iterable[Any]) → bool¶: Gibt True zurück, wenn alle Elemente von iterable wahr sind (oder wenn das Iterable leer ist).

any(iterable: Iterable[Any]) → bool¶: Gibt True zurück, wenn irgendein Element von iterable wahr ist. Gibt False zurück, wenn das Iterable leer ist.

bin(x: int) → str¶: Wandelt eine Ganzzahl in eine binäre Zeichenkette mit dem Präfix "0b" um. Das Argument muss eine Python-Ganzzahl sein oder __index__() implementieren.

class bool(x: Any = False)¶: Gibt einen booleschen Wert zurück, d.h. entweder True oder False. x wird mithilfe des Standard-Wahrheitstests umgewandelt.

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

Veränderbare Folge von Ganzzahlen im Bereich 0-255. Die Erzeugung folgt denselben Regeln wie bei bytes: aus einer Ganzzahl (es wird ein mit Nullen gefüllter Puffer dieser Größe erzeugt), aus einem Iterable von Ganzzahlen, aus einer Zeichenkette mit encoding oder aus einem beliebigen Objekt, das das Buffer-Protokoll unterstützt. Unterstützt die Standard-Folgenoperationen sowie die direkte Veränderung.

classmethod fromhex(string: str) → bytearray¶: Erzeugt ein bytearray aus einer Zeichenkette von Hexadezimalziffernpaaren. Leerzeichen zwischen Ziffernpaaren werden übersprungen; ein Nicht-Hex-Zeichen löst ValueError aus.

append(val: int) → None¶: Hängt einen einzelnen Wert (eine Ganzzahl im Bereich 0-255) an das Ende des bytearray an und vergrößert es um ein Byte.

center(width: int, fillbyte: bytes) → bytes¶: Gibt eine Kopie des Inhalts zurück, zentriert in einer Folge der Länge width und mit fillbyte aufgefüllt. Anders als in CPython ist fillbyte erforderlich. Die Daten werden unverändert zurückgegeben, wenn width nicht größer als die aktuelle Länge ist.

count(sub: bytes, start: int = 0, end: int = -1) → int¶: Gibt die Anzahl der nicht überlappenden Vorkommen von sub im Slice [start:end] zurück.

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool¶: Gibt True zurück, wenn der Inhalt mit suffix endet. Anders als in CPython kann suffix kein Tupel von Werten sein.

extend(iterable: Iterable[int]) → None¶: Hängt alle Elemente von iterable an das Ende des bytearray an. Als Erweiterung gegenüber CPython kann jedes Objekt verwendet werden, das das Buffer-Protokoll unterstützt.

find(sub: bytes, start: int = 0, end: int = -1) → int¶: Gibt den niedrigsten Index zurück, an dem sub innerhalb des Slice [start:end] gefunden wird, oder -1, falls es nicht gefunden wird.

format(*args: Any, **kwargs: Any) → str¶: Führt eine Zeichenketten-Formatierung durch, wobei der Inhalt als Formatzeichenkette verwendet wird, und gibt das formatierte Ergebnis zurück.

hex(sep: str = '') → str¶: Gibt eine Zeichenkette aus zwei Hexadezimalziffern für jedes Byte zurück. Wird das optionale sep (eine Zeichenkette der Länge 1) angegeben, wird es zwischen aufeinanderfolgenden Bytewerten eingefügt.

index(sub: bytes, start: int = 0, end: int = -1) → int¶: Wie find(), löst aber ValueError aus, wenn sub nicht gefunden wird.

isalpha() → bool¶: Gibt True zurück, wenn alle Bytes alphabetische ASCII-Zeichen sind und mindestens ein Byte vorhanden ist, andernfalls False.

isdigit() → bool¶: Gibt True zurück, wenn alle Bytes ASCII-Dezimalziffern sind und mindestens ein Byte vorhanden ist, andernfalls False.

islower() → bool¶: Gibt True zurück, wenn alle Bytes mit Groß-/Kleinschreibung kleingeschrieben sind und mindestens ein solches Byte vorhanden ist, andernfalls False.

isspace() → bool¶: Gibt True zurück, wenn alle Bytes ASCII-Leerraumzeichen sind und mindestens ein Byte vorhanden ist, andernfalls False.

isupper() → bool¶: Gibt True zurück, wenn alle Bytes mit Groß-/Kleinschreibung großgeschrieben sind und mindestens ein solches Byte vorhanden ist, andernfalls False.

join(iterable: Iterable[bytes]) → bytes¶: Gibt ein bytes-Objekt zurück, das aus der Verkettung der Elemente in iterable besteht, wobei der Inhalt des bytearray als Trennzeichen verwendet wird.

lower() → bytes¶: Gibt eine Kopie des Inhalts zurück, bei der alle ASCII-Großbuchstaben in Kleinbuchstaben umgewandelt sind.

lstrip(chars: bytes | None = None) → bytes¶: Gibt eine Kopie zurück, bei der führende Bytes entfernt sind. chars gibt die Menge der zu entfernenden Bytes an; wird es weggelassen oder ist None, werden ASCII-Leerraumzeichen entfernt.

partition(sep: bytes) → tuple¶: Teilt beim ersten Vorkommen von sep und gibt (head, sep, tail) zurück. Wird sep nicht gefunden, wird der Inhalt gefolgt von zwei leeren Objekten zurückgegeben.

replace(old: bytes, new: bytes, count: int = -1) → bytes¶: Gibt eine Kopie zurück, bei der alle Vorkommen von old durch new ersetzt sind. Wird count angegeben, werden nur die ersten count Vorkommen ersetzt.

rfind(sub: bytes, start: int = 0, end: int = -1) → int¶: Gibt den höchsten Index zurück, an dem sub innerhalb des Slice [start:end] gefunden wird, oder -1, falls es nicht gefunden wird.

rindex(sub: bytes, start: int = 0, end: int = -1) → int¶: Wie rfind(), löst aber ValueError aus, wenn sub nicht gefunden wird.

rpartition(sep: bytes) → tuple¶: Teilt beim letzten Vorkommen von sep und gibt (head, sep, tail) zurück. Wird sep nicht gefunden, werden zwei leere Objekte gefolgt vom Inhalt zurückgegeben.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list¶: Teilt bei Vorkommen von sep in eine Liste von Teilen auf und führt dabei höchstens maxsplit Teilungen von rechts gezählt durch. Ist sep None oder wird es weggelassen, wird an Folgen von ASCII-Leerraumzeichen geteilt.

rstrip(chars: bytes | None = None) → bytes¶: Gibt eine Kopie zurück, bei der nachfolgende Bytes entfernt sind. chars gibt die Menge der zu entfernenden Bytes an; wird es weggelassen oder ist None, werden ASCII-Leerraumzeichen entfernt.

split(sep: bytes | None = None, maxsplit: int = -1) → list¶: Teilt bei Vorkommen von sep in eine Liste von Teilen auf. Ist sep None oder wird es weggelassen, wird an Folgen von ASCII-Leerraumzeichen geteilt und führender/nachfolgender Leerraum ignoriert.

splitlines(keepends: bool = False) → list¶: Gibt eine Liste der Zeilen zurück, wobei an \n, \r und \r\n umgebrochen wird. Zeilenumbrüche werden ausgeschlossen, sofern keepends nicht wahr ist.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool¶: Gibt True zurück, wenn der Inhalt mit prefix beginnt. Anders als in CPython kann prefix kein Tupel sein, und end wird akzeptiert, aber ignoriert.

strip(chars: bytes | None = None) → bytes¶: Gibt eine Kopie zurück, bei der führende und nachfolgende Bytes entfernt sind. chars gibt die Menge der zu entfernenden Bytes an; wird es weggelassen oder ist None, werden ASCII-Leerraumzeichen entfernt.

upper() → bytes¶: Gibt eine Kopie des Inhalts zurück, bei der alle ASCII-Kleinbuchstaben in Großbuchstaben umgewandelt sind.

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

Unveränderbare Folge von Ganzzahlen im Bereich 0-255. Erzeugt aus einer Ganzzahl (mit Nullen gefüllter Puffer), aus einem Iterable von Ganzzahlen, aus einer Zeichenkette mit encoding oder aus einem beliebigen Objekt, das das Buffer-Protokoll unterstützt. Bytes-Literale verwenden die Syntax b'...'.

classmethod fromhex(string: str) → bytes¶: Erzeugt ein bytes-Objekt aus einer Zeichenkette von Hexadezimalziffernpaaren. Leerzeichen zwischen Ziffernpaaren werden übersprungen; ein Nicht-Hex-Zeichen löst ValueError aus.

center(width: int, fillbyte: bytes) → bytes¶: Gibt eine Kopie zurück, zentriert in einer Folge der Länge width und mit fillbyte aufgefüllt (ein bytes-Wert der Länge 1, das das Füllbyte angibt). Anders als in CPython ist fillbyte erforderlich. Das ursprüngliche Objekt wird unverändert zurückgegeben, wenn width nicht größer als seine Länge ist.

count(sub: bytes, start: int = 0, end: int = -1) → int¶: Gibt die Anzahl der nicht überlappenden Vorkommen von sub im Slice [start:end] zurück.

decode(encoding: str = 'utf-8') → str¶: Gibt eine aus den Bytes dekodierte str zurück. In MicroPython wird das Argument encoding akzeptiert, aber praktisch ignoriert (die Bytes werden als UTF-8 neu interpretiert).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool¶: Gibt True zurück, wenn die Bytes mit suffix enden. Anders als in CPython kann suffix kein Tupel von Werten zum Ausprobieren sein.

find(sub: bytes, start: int = 0, end: int = -1) → int¶: Gibt den niedrigsten Index zurück, an dem die Teilfolge sub innerhalb des Slice [start:end] gefunden wird, oder -1, falls sie nicht gefunden wird.

format(*args: Any, **kwargs: Any) → str¶: Führt eine Zeichenketten-Formatierung durch, wobei die Bytes als Formatzeichenkette verwendet werden, und gibt das formatierte Ergebnis zurück.

hex(sep: str = '') → str¶: Gibt eine Zeichenkette aus zwei Hexadezimalziffern für jedes Byte zurück. Wird das optionale sep (eine Zeichenkette der Länge 1) angegeben, wird es zwischen aufeinanderfolgenden Bytewerten eingefügt.

index(sub: bytes, start: int = 0, end: int = -1) → int¶: Wie find(), löst aber ValueError aus, wenn sub nicht gefunden wird.

isalpha() → bool¶: Gibt True zurück, wenn alle Bytes alphabetische ASCII-Zeichen sind und mindestens ein Byte vorhanden ist, andernfalls False.

isdigit() → bool¶: Gibt True zurück, wenn alle Bytes ASCII-Dezimalziffern sind und mindestens ein Byte vorhanden ist, andernfalls False.

islower() → bool¶: Gibt True zurück, wenn alle Bytes mit Groß-/Kleinschreibung kleingeschrieben sind und mindestens ein solches Byte vorhanden ist, andernfalls False.

isspace() → bool¶: Gibt True zurück, wenn alle Bytes ASCII-Leerraumzeichen sind und mindestens ein Byte vorhanden ist, andernfalls False.

isupper() → bool¶: Gibt True zurück, wenn alle Bytes mit Groß-/Kleinschreibung großgeschrieben sind und mindestens ein solches Byte vorhanden ist, andernfalls False.

join(iterable: Iterable[bytes]) → bytes¶: Gibt ein bytes-Objekt zurück, das aus der Verkettung der Elemente in iterable besteht, wobei das bytes-Objekt selbst als Trennzeichen verwendet wird.

lower() → bytes¶: Gibt eine Kopie zurück, bei der alle ASCII-Großbuchstaben in Kleinbuchstaben umgewandelt sind.

lstrip(chars: bytes | None = None) → bytes¶: Gibt eine Kopie zurück, bei der führende Bytes entfernt sind. chars gibt die Menge der zu entfernenden Bytes an; wird es weggelassen oder ist None, werden ASCII-Leerraumzeichen entfernt.

partition(sep: bytes) → tuple¶: Teilt beim ersten Vorkommen von sep und gibt (head, sep, tail) zurück. Wird sep nicht gefunden, werden die Bytes gefolgt von zwei leeren bytes-Objekten zurückgegeben.

replace(old: bytes, new: bytes, count: int = -1) → bytes¶: Gibt eine Kopie zurück, bei der alle Vorkommen von old durch new ersetzt sind. Wird count angegeben, werden nur die ersten count Vorkommen ersetzt.

rfind(sub: bytes, start: int = 0, end: int = -1) → int¶: Gibt den höchsten Index zurück, an dem sub innerhalb des Slice [start:end] gefunden wird, oder -1, falls es nicht gefunden wird.

rindex(sub: bytes, start: int = 0, end: int = -1) → int¶: Wie rfind(), löst aber ValueError aus, wenn sub nicht gefunden wird.

rpartition(sep: bytes) → tuple¶: Teilt beim letzten Vorkommen von sep und gibt (head, sep, tail) zurück. Wird sep nicht gefunden, werden zwei leere bytes-Objekte gefolgt von den Bytes zurückgegeben.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list¶: Teilt bei Vorkommen von sep in eine Liste von Teilen auf und führt dabei höchstens maxsplit Teilungen von rechts gezählt durch. Ist sep None oder wird es weggelassen, wird an Folgen von ASCII-Leerraumzeichen geteilt.

rstrip(chars: bytes | None = None) → bytes¶: Gibt eine Kopie zurück, bei der nachfolgende Bytes entfernt sind. chars gibt die Menge der zu entfernenden Bytes an; wird es weggelassen oder ist None, werden ASCII-Leerraumzeichen entfernt.

split(sep: bytes | None = None, maxsplit: int = -1) → list¶: Teilt bei Vorkommen von sep in eine Liste von Teilen auf. Ist sep None oder wird es weggelassen, wird an Folgen von ASCII-Leerraumzeichen geteilt und führender/nachfolgender Leerraum ignoriert.

splitlines(keepends: bool = False) → list¶: Gibt eine Liste der Zeilen zurück, wobei an \n, \r und \r\n umgebrochen wird. Zeilenumbrüche werden ausgeschlossen, sofern keepends nicht wahr ist.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool¶: Gibt True zurück, wenn die Bytes mit prefix beginnen. Anders als in CPython kann prefix kein Tupel sein, und end wird akzeptiert, aber ignoriert.

strip(chars: bytes | None = None) → bytes¶: Gibt eine Kopie zurück, bei der führende und nachfolgende Bytes entfernt sind. chars gibt die Menge der zu entfernenden Bytes an; wird es weggelassen oder ist None, werden ASCII-Leerraumzeichen entfernt.

upper() → bytes¶: Gibt eine Kopie zurück, bei der alle ASCII-Kleinbuchstaben in Großbuchstaben umgewandelt sind.

callable(obj: Any) → bool¶: Gibt True zurück, wenn obj aufrufbar erscheint, andernfalls False.

chr(i: int) → str¶: Gibt eine Zeichenkette aus einem Zeichen zurück, dessen Unicode-Codepunkt die Ganzzahl i ist.

classmethod(func: Callable[..., Any]) → classmethod¶: Wandelt eine Methode in eine Klassenmethode um. Wird typischerweise als Dekorator verwendet.

compile(source: str | bytes, filename: str, mode: str) → Any¶: Kompiliert source zu einem Code-Objekt, das von exec() oder eval() ausgeführt werden kann. mode ist einer von "exec", "eval" oder "single".

class complex(real: float | str = 0, imag: float = 0)¶: Erzeugt eine komplexe Zahl aus einem Real- und einem Imaginärteil oder aus einer Zeichenkette.

delattr(obj, name: str) → None¶: Das Argument name sollte eine Zeichenkette sein, und diese Funktion löscht das benannte Attribut aus dem durch obj angegebenen Objekt.

class dict(*args, **kwargs)¶

Erzeugt ein neues Dictionary. Entspricht CPythons dict.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict¶: Erzeugt ein neues Dictionary mit Schlüsseln aus iterable, die jeweils auf value abgebildet werden (Standardwert None). Wird auf dem Typ aufgerufen, z.B. dict.fromkeys(...).

clear() → None¶: Entfernt alle Elemente aus dem Dictionary, sodass es leer ist. Löst TypeError aus, wenn das Dictionary fest (schreibgeschützt) ist.

copy() → dict¶: Gibt eine flache Kopie des Dictionarys zurück. Das zurückgegebene Objekt hat denselben Typ wie das Original (dict oder OrderedDict), ist aber nicht fest.

get(key: Any, default: Any = None) → Any¶: Gibt den Wert für key zurück, falls er im Dictionary enthalten ist, andernfalls default (das selbst standardmäßig None ist, sodass dies nie KeyError auslöst). Das Dictionary wird nicht verändert.

items() → Any¶: Gibt ein dynamisches View-Objekt über die (key, value)-Paare zurück, das nachfolgende Änderungen am Dictionary widerspiegelt und Iteration, len(), den in-Operator und Mengenvergleichsoperatoren unterstützt.

keys() → Any¶: Gibt ein dynamisches View-Objekt über die Schlüssel zurück, das nachfolgende Änderungen am Dictionary widerspiegelt und Iteration, len(), den in-Operator und Mengenvergleichsoperatoren unterstützt.

pop(key: Any, default: Any = None) → Any¶: Entfernt key aus dem Dictionary und gibt seinen Wert zurück. Ist key nicht vorhanden, wird default zurückgegeben, falls es angegeben wurde; andernfalls wird KeyError ausgelöst. Löst TypeError aus, wenn das Dictionary fest ist.

popitem() → tuple¶: Entfernt ein beliebiges (key, value)-Paar und gibt es als 2-Tupel zurück. Bei einem einfachen dict ist das gewählte Paar nicht festgelegt; bei einem OrderedDict wird das zuletzt eingefügte Paar entfernt (LIFO). Löst KeyError aus, wenn das Dictionary leer ist, oder TypeError, wenn es fest ist.

setdefault(key: Any, default: Any = None) → Any¶: Ist key im Dictionary enthalten, wird sein Wert zurückgegeben. Andernfalls wird key mit dem Wert default (Standardwert None) eingefügt und dieser Wert zurückgegeben. Löst TypeError aus, wenn das Dictionary fest ist.

update(*args: Any, **kwargs: Any) → None¶: Aktualisiert das Dictionary direkt. Es wird höchstens ein Positionsargument akzeptiert: entweder ein weiteres Dictionary oder ein Iterable aus zweielementigen (key, value)-Paaren (jedes muss genau zwei Elemente liefern, sonst wird ValueError ausgelöst). Schlüsselwortargumente werden anschließend als Einträge mit Zeichenkettenschlüsseln hinzugefügt. Vorhandene Schlüssel werden überschrieben. Löst TypeError aus, wenn das Dictionary fest ist.

values() → Any¶: Gibt ein dynamisches View-Objekt über die Werte zurück, das nachfolgende Änderungen am Dictionary widerspiegelt und Iteration sowie len() unterstützt.

__getitem__(key: Any) → Any¶: Gibt self[key] zurück. Implementiert den Indexierungsoperator d[key]; löst KeyError aus, wenn key nicht vorhanden ist.

__setitem__(key: Any, value: Any) → None¶: Setzt self[key] auf value. Implementiert d[key] = value.

__delitem__(key: Any) → None¶: Löscht self[key]. Implementiert del d[key]; löst KeyError aus, wenn key nicht vorhanden ist.

dir(obj: Any = None) → list¶: Ohne Argumente wird die Liste der Namen im aktuellen lokalen Geltungsbereich zurückgegeben. Mit einem Argument wird eine Liste der gültigen Attribute für dieses Objekt zurückgegeben.

divmod(a: Any, b: Any) → tuple¶: Gibt das Paar (a // b, a % b) als Tupel zurück, für zwei (nicht komplexe) Zahlen.

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]¶: Gibt ein enumerate-Objekt zurück, das (index, value)-Paare aus iterable liefert, wobei der Index bei start beginnt.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any¶: Wertet einen als Zeichenkette (oder kompiliertes Code-Objekt) angegebenen Python-Ausdruck aus und gibt das Ergebnis zurück.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None¶: Führt Python-Code, der als Zeichenkette oder kompiliertes Code-Objekt bereitgestellt wird, dynamisch aus.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]¶: Erzeugt einen Iterator aus den Elementen von iterable, für die function wahr zurückgibt. Ist function None, wird die Identitätsfunktion angenommen.

class float(x: str | bytes | int | float = 0.0)¶: Gibt eine aus einer Zahl oder Zeichenkette x erzeugte Gleitkommazahl zurück.

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

Gibt ein neues frozenset-Objekt zurück, optional mit Elementen aus iterable. frozenset ist eine unveränderbare, hashbare Variante von set.

copy() → frozenset¶: Gibt eine flache Kopie des frozenset zurück.

difference(*others: Iterable[Any]) → frozenset¶: Gibt ein neues frozenset mit den Elementen des frozenset zurück, die in keinem der others enthalten sind. Jedes Argument kann ein beliebiges Iterable sein.

intersection(other: Iterable[Any]) → frozenset¶: Gibt ein neues frozenset mit den Elementen zurück, die dem frozenset und other gemeinsam sind. In MicroPython wird nur ein einziges Argument other akzeptiert (CPython akzeptiert mehrere).

isdisjoint(other: Iterable[Any]) → bool¶: Gibt True zurück, wenn das frozenset keine Elemente mit other gemeinsam hat.

issubset(other: Iterable[Any]) → bool¶: Gibt True zurück, wenn jedes Element des frozenset in other enthalten ist.

issuperset(other: Iterable[Any]) → bool¶: Gibt True zurück, wenn jedes Element von other im frozenset enthalten ist.

symmetric_difference(other: Iterable[Any]) → frozenset¶: Gibt ein neues frozenset mit den Elementen zurück, die entweder im frozenset oder in other enthalten sind, aber nicht in beiden. In MicroPython wird nur ein einziges Argument other akzeptiert.

union(other: Iterable[Any]) → frozenset¶: Gibt ein neues frozenset mit den Elementen aus dem frozenset und other zurück. In MicroPython wird nur ein einziges Argument other akzeptiert (CPython akzeptiert mehrere).

getattr(obj: Any, name: str, default: Any = None) → Any¶: Gibt den Wert des benannten Attributs von obj zurück. Existiert das Attribut nicht, wird default zurückgegeben, falls angegeben, andernfalls wird AttributeError ausgelöst.

globals() → dict¶: Gibt ein Dictionary zurück, das die globale Symboltabelle des aktuellen Moduls darstellt.

hasattr(obj: Any, name: str) → bool¶: Gibt True zurück, wenn obj ein Attribut mit dem angegebenen name hat, andernfalls False.

hash(obj: Any) → int¶: Gibt den Hash-Wert von obj zurück (falls es einen hat). Hash-Werte sind Ganzzahlen, die verwendet werden, um Dictionary-Schlüssel bei einer Dictionary-Suche schnell zu vergleichen.

hex(x: int) → str¶: Wandelt eine Ganzzahl in eine hexadezimale Zeichenkette in Kleinbuchstaben mit dem Präfix "0x" um.

id(obj: Any) → int¶: Gibt die Identität eines Objekts zurück. Dies ist eine Ganzzahl, die garantiert während der Lebensdauer dieses Objekts eindeutig und konstant ist.

input(prompt: str = '') → str¶: Liest eine Zeile von der Standardeingabe und gibt sie als Zeichenkette zurück (ohne abschließenden Zeilenumbruch). Wird prompt angegeben, wird es zuvor ohne abschließenden Zeilenumbruch in die Standardausgabe geschrieben.

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

classmethod from_bytes(bytes: bytes, byteorder: str) → int¶: In MicroPython muss der Parameter byteorder positional sein (dies ist mit CPython kompatibel).

to_bytes(size: int, byteorder: str) → bytes¶: In MicroPython muss der Parameter byteorder positional sein (dies ist mit CPython kompatibel).

Bemerkung

Das optionale Schlüsselwortargument signed aus CPython wird nicht unterstützt. MicroPython wandelt negative Ganzzahlen derzeit als vorzeichenbehaftet und positive als vorzeichenlos um. (Details.)

isinstance(obj: Any, classinfo: type | tuple) → bool¶: Gibt True zurück, wenn obj eine Instanz von classinfo oder einer seiner Unterklassen ist. classinfo kann eine Klasse oder ein Tupel von Klassen sein.

issubclass(cls: type, classinfo: type | tuple) → bool¶: Gibt True zurück, wenn cls eine (direkte, indirekte oder virtuelle) Unterklasse von classinfo ist.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]¶: Gibt ein Iterator-Objekt zurück. Mit einem Argument muss obj das Iterationsprotokoll unterstützen. Mit zwei Argumenten muss obj aufrufbar sein, und die Iteration stoppt, wenn es sentinel zurückgibt.

len(obj: Any) → int¶: Gibt die Anzahl der Elemente in einem Container zurück.

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

Erzeugt eine neue Liste, optional gefüllt mit Elementen aus iterable.

append(object: Any) → None¶: Hängt object an das Ende der Liste an.

clear() → None¶: Entfernt alle Elemente aus der Liste, sodass sie leer ist.

copy() → list¶: Gibt eine flache Kopie der Liste zurück.

count(value: Any) → int¶: Gibt die Anzahl der Elemente in der Liste zurück, die gleich value sind.

extend(iterable: Iterable[Any]) → None¶: Hängt alle Elemente von iterable an das Ende der Liste an. Ist iterable selbst eine Liste, werden ihre Elemente direkt kopiert; andernfalls wird darüber iteriert.

index(value: Any, start: int = 0, stop: int = -1) → int¶: Gibt den Index des ersten Elements zurück, das gleich value ist, wobei der Slice [start:stop] durchsucht wird. Löst ValueError aus, wenn value nicht vorhanden ist.

insert(index: int, object: Any) → None¶: Fügt object vor der Position index ein. Ein negativer index wird relativ zum Ende der Liste interpretiert, und der Index wird auf den gültigen Bereich begrenzt (sodass Werte jenseits eines Endes am Anfang oder Ende eingefügt werden).

pop(index: int = -1) → Any¶: Entfernt das Element an Position index (standardmäßig das letzte Element) und gibt es zurück. Löst IndexError aus, wenn die Liste leer ist oder index außerhalb des Bereichs liegt.

remove(value: Any) → None¶: Entfernt das erste Element, das gleich value ist. Löst ValueError aus, wenn value nicht vorhanden ist.

reverse() → None¶: Kehrt die Reihenfolge der Elemente der Liste direkt um.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None¶: Sortiert die Elemente der Liste direkt. key und reverse sind nur als Schlüsselwortargumente zulässig. key ist, falls angegeben, eine Funktion, die auf jedes Element angewendet wird, um den Vergleichswert zu erzeugen; reverse sortiert in absteigender Reihenfolge.

Bemerkung

Anders als in CPython ist die Listensortierung von MicroPython nicht stabil.

locals() → dict¶: Gibt ein Dictionary zurück, das die aktuelle lokale Symboltabelle darstellt.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]¶: Gibt einen Iterator zurück, der function auf jedes Element von iterables anwendet und die Ergebnisse liefert.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any¶: Mit einem einzelnen Iterable-Argument wird dessen größtes Element zurückgegeben. Mit zwei oder mehr Argumenten wird das größte Argument zurückgegeben.

class memoryview(obj: Any)¶: Erzeugt eine memoryview, die auf obj verweist, das das Buffer-Protokoll unterstützen muss (z.B. bytes, bytearray, array.array). Ermöglicht den kopierfreien Zugriff auf den zugrunde liegenden Speicher und dessen Slicing; das Slicing einer memoryview gibt eine weitere memoryview anstelle einer Kopie zurück.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any¶: Mit einem einzelnen Iterable-Argument wird dessen kleinstes Element zurückgegeben. Mit zwei oder mehr Argumenten wird das kleinste Argument zurückgegeben.

next(iterator: Iterator[Any], default: Any = None) → Any¶: Holt das nächste Element von iterator. Wird default angegeben und ist der Iterator erschöpft, wird default zurückgegeben, anstatt StopIteration auszulösen.

class object¶: Gibt ein neues, eigenschaftsloses Objekt zurück. object ist die Basisklasse für alle Klassen.

oct(x: int) → str¶: Wandelt eine Ganzzahl in eine oktale Zeichenkette mit dem Präfix "0o" um.

open(file: str, mode: str = 'r', **kwargs) → Any¶: Öffnet file und gibt ein entsprechendes Dateiobjekt zurück. mode ist standardmäßig "r" zum Lesen von Text.

ord(c: str) → int¶: Gibt den Unicode-Codepunkt einer Zeichenkette c aus einem einzelnen Zeichen als Ganzzahl zurück.

pow(base: Any, exp: Any, mod: Any | None = None) → Any¶: Gibt base hoch exp zurück. Wird mod angegeben, wird base ** exp % mod zurückgegeben (effizienter berechnet als die explizite Form).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None¶: Gibt objects in den Textstream file aus, getrennt durch sep und gefolgt von 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¶: Gibt ein property-Attribut zurück. Wird typischerweise als Dekorator verwendet, um verwaltete Attribute auf einer Klasse zu definieren.

range(*args: int) → range¶: Gibt eine unveränderbare Folge von Ganzzahlen zurück. Aufgerufen als range(stop), range(start, stop) oder range(start, stop, step).

repr(obj: Any) → str¶: Gibt eine Zeichenkette zurück, die eine druckbare Darstellung von obj enthält.

reversed(seq: Any) → Iterator[Any]¶: Gibt einen umgekehrten Iterator über die Werte der angegebenen Folge zurück.

round(number: Any, ndigits: int | None = None) → Any¶: Gibt number gerundet auf ndigits Dezimalstellen zurück. Wird ndigits weggelassen, wird die nächste Ganzzahl zurückgegeben.

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

Gibt ein neues set-Objekt zurück, optional mit Elementen aus iterable.

add(elem: Any) → None¶: Fügt das Element elem zur Menge hinzu.

clear() → None¶: Entfernt alle Elemente aus der Menge.

copy() → set¶: Gibt eine flache Kopie der Menge zurück.

difference(*others: Iterable[Any]) → set¶: Gibt eine neue Menge mit den Elementen der Menge zurück, die in keinem der others enthalten sind. Jedes Argument kann ein beliebiges Iterable sein.

difference_update(*others: Iterable[Any]) → None¶: Entfernt aus der Menge alle Elemente, die in irgendeinem der others gefunden werden (direkt).

discard(elem: Any) → None¶: Entfernt das Element elem aus der Menge, falls es vorhanden ist. Anders als remove() löst dies keinen Fehler aus, wenn elem nicht vorhanden ist.

intersection(other: Iterable[Any]) → set¶: Gibt eine neue Menge mit den Elementen zurück, die der Menge und other gemeinsam sind. In MicroPython wird nur ein einziges Argument other akzeptiert (CPython akzeptiert mehrere).

intersection_update(other: Iterable[Any]) → None¶: Aktualisiert die Menge, sodass nur die Elemente erhalten bleiben, die auch in other enthalten sind (direkt). In MicroPython wird nur ein einziges Argument other akzeptiert.

isdisjoint(other: Iterable[Any]) → bool¶: Gibt True zurück, wenn die Menge keine Elemente mit other gemeinsam hat.

issubset(other: Iterable[Any]) → bool¶: Gibt True zurück, wenn jedes Element der Menge in other enthalten ist.

issuperset(other: Iterable[Any]) → bool¶: Gibt True zurück, wenn jedes Element von other in der Menge enthalten ist.

pop() → Any¶: Entfernt ein beliebiges Element aus der Menge und gibt es zurück. Löst KeyError aus, wenn die Menge leer ist.

remove(elem: Any) → None¶: Entfernt das Element elem aus der Menge. Löst KeyError aus, wenn elem nicht in der Menge enthalten ist.

symmetric_difference(other: Iterable[Any]) → set¶: Gibt eine neue Menge mit den Elementen zurück, die entweder in der Menge oder in other enthalten sind, aber nicht in beiden. In MicroPython wird nur ein einziges Argument other akzeptiert.

symmetric_difference_update(other: Iterable[Any]) → None¶: Aktualisiert die Menge, sodass nur die Elemente erhalten bleiben, die entweder in der Menge oder in other enthalten sind, aber nicht in beiden (direkt). In MicroPython wird nur ein einziges Argument other akzeptiert.

union(other: Iterable[Any]) → set¶: Gibt eine neue Menge mit den Elementen aus der Menge und other zurück. In MicroPython wird nur ein einziges Argument other akzeptiert (CPython akzeptiert mehrere).

update(*others: Iterable[Any]) → None¶: Aktualisiert die Menge, indem Elemente aus allen others hinzugefügt werden (direkt).

setattr(obj: Any, name: str, value: Any) → None¶: Setzt das benannte Attribut von obj auf value. Das Gegenstück zu getattr().

class slice¶: Der eingebaute slice ist der Typ, den slice-Objekte haben.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list¶: Gibt eine neue sortierte Liste aus den Elementen in iterable zurück.

staticmethod(func: Callable[..., Any]) → staticmethod¶: Wandelt eine Methode in eine statische Methode um. Wird typischerweise als Dekorator verwendet.

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

Gibt eine Zeichenkettenversion von object zurück. Ist object ein bytes-ähnliches Objekt, steuern die Argumente encoding und errors die Dekodierung.

center(width: int) → str¶: Gibt eine Kopie der Zeichenkette zurück, zentriert in einem Feld der Länge width und mit Leerzeichen aufgefüllt. In MicroPython wird nur ein Leerzeichen als Füllzeichen verwendet (es gibt kein Füllzeichen-Argument), und die ursprüngliche Zeichenkette wird unverändert zurückgegeben, wenn width nicht größer als ihre Länge ist.

count(sub: str, start: int = 0, end: int = -1) → int¶: Gibt die Anzahl der nicht überlappenden Vorkommen von sub im Slice [start:end] zurück. Ein leeres sub zählt jede Lücke zwischen Zeichen.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes¶: Gibt ein bytes-Objekt zurück, das die Zeichenkette kodiert. MicroPython ignoriert die Argumente praktisch und verwendet UTF-8; errors wird akzeptiert, aber nicht berücksichtigt. Entspricht bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool¶: Gibt True zurück, wenn die Zeichenkette mit dem angegebenen suffix endet, das eine einzelne Zeichenkette oder ein Tupel von Zeichenketten zum Ausprobieren sein kann. Die optionalen start und end schränken den Vergleich auf den Slice [start:end] ein.

find(sub: str, start: int = 0, end: int = -1) → int¶: Gibt den niedrigsten Index in der Zeichenkette zurück, an dem die Teilzeichenkette sub innerhalb des Slice [start:end] gefunden wird, oder -1, falls sie nicht gefunden wird.

format(*args: Any, **kwargs: Any) → str¶: Führt eine Zeichenketten-Formatierung durch, wobei durch geschweifte Klammern {} begrenzte Ersetzungsfelder mit Werten aus args und kwargs ersetzt werden. Unterstützt die Standard-Mini-Sprache für Formatspezifikationen.

index(sub: str, start: int = 0, end: int = -1) → int¶: Wie find(), löst aber ValueError aus, wenn die Teilzeichenkette sub im Slice [start:end] nicht gefunden wird.

isalpha() → bool¶: Gibt True zurück, wenn alle Zeichen in der Zeichenkette alphabetisch sind und die Zeichenkette nicht leer ist, andernfalls False.

isdigit() → bool¶: Gibt True zurück, wenn alle Zeichen in der Zeichenkette Ziffern sind und die Zeichenkette nicht leer ist, andernfalls False.

islower() → bool¶: Gibt True zurück, wenn die Zeichenkette mindestens ein alphabetisches Zeichen enthält und alle solchen Zeichen kleingeschrieben sind, andernfalls False.

isspace() → bool¶: Gibt True zurück, wenn alle Zeichen in der Zeichenkette Leerraumzeichen sind und die Zeichenkette nicht leer ist, andernfalls False.

isupper() → bool¶: Gibt True zurück, wenn die Zeichenkette mindestens ein alphabetisches Zeichen enthält und alle solchen Zeichen großgeschrieben sind, andernfalls False.

join(iterable: Iterable[str]) → str¶: Verkettet die Zeichenketten in iterable und fügt diese Zeichenkette als Trennzeichen zwischen den Elementen ein. Die Elemente müssen Zeichenketten sein, andernfalls wird TypeError ausgelöst.

lower() → str¶: Gibt eine Kopie der Zeichenkette zurück, bei der alle Zeichen in Kleinbuchstaben umgewandelt sind.

lstrip(chars: str | None = None) → str¶: Gibt eine Kopie der Zeichenkette zurück, bei der führende Zeichen entfernt sind. Wird chars weggelassen oder ist None, wird Leerraum entfernt; andernfalls wird chars als Menge der zu entfernenden Zeichen behandelt.

partition(sep: str) → tuple¶: Teilt die Zeichenkette beim ersten Vorkommen von sep und gibt ein 3-Tupel (head, sep, tail) zurück. Wird sep nicht gefunden, wird (self, "", "") zurückgegeben. Ein leeres sep löst ValueError aus.

replace(old: str, new: str, count: int = -1) → str¶: Gibt eine Kopie der Zeichenkette zurück, bei der alle Vorkommen der Teilzeichenkette old durch new ersetzt sind. Wird count angegeben und ist nicht negativ, werden nur die ersten count Vorkommen ersetzt.

rfind(sub: str, start: int = 0, end: int = -1) → int¶: Gibt den höchsten Index in der Zeichenkette zurück, an dem die Teilzeichenkette sub innerhalb des Slice [start:end] gefunden wird, oder -1, falls sie nicht gefunden wird.

rindex(sub: str, start: int = 0, end: int = -1) → int¶: Wie rfind(), löst aber ValueError aus, wenn die Teilzeichenkette sub im Slice [start:end] nicht gefunden wird.

rpartition(sep: str) → tuple¶: Teilt die Zeichenkette beim letzten Vorkommen von sep und gibt ein 3-Tupel (head, sep, tail) zurück. Wird sep nicht gefunden, wird ("", "", self) zurückgegeben. Ein leeres sep löst ValueError aus.

rsplit(sep: str | None = None, maxsplit: int = -1) → list¶: Teilt die Zeichenkette von rechts in eine Liste von Teilzeichenketten auf, wobei sep als Trennzeichen verwendet wird und höchstens maxsplit Teilungen durchgeführt werden. Ohne maxsplit (oder mit einem negativen Wert) verhält es sich identisch zu split(); in MicroPython löst rsplit(None, n) mit einem nicht negativen n NotImplementedError aus.

rstrip(chars: str | None = None) → str¶: Gibt eine Kopie der Zeichenkette zurück, bei der nachfolgende Zeichen entfernt sind. Wird chars weggelassen oder ist None, wird Leerraum entfernt; andernfalls wird chars als Menge der zu entfernenden Zeichen behandelt.

split(sep: str | None = None, maxsplit: int = -1) → list¶: Teilt die Zeichenkette in eine Liste von Teilzeichenketten auf, wobei sep als Trennzeichen verwendet wird und höchstens maxsplit Teilungen durchgeführt werden. Wird sep weggelassen oder ist None, wird an Folgen von Leerraum geteilt, wobei führender Leerraum ignoriert wird; andernfalls löst ein leeres sep ValueError aus.

splitlines(keepends: bool = False) → list¶: Gibt eine Liste der Zeilen in der Zeichenkette zurück, wobei an \n, \r und \r\n umgebrochen wird. Zeilenumbrüche werden nicht eingeschlossen, sofern keepends nicht wahr ist.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool¶: Gibt True zurück, wenn die Zeichenkette mit dem angegebenen prefix beginnt, das eine einzelne Zeichenkette oder ein Tupel von Zeichenketten zum Ausprobieren sein kann. Die optionalen start und end schränken den Vergleich auf den Slice [start:end] ein.

strip(chars: str | None = None) → str¶: Gibt eine Kopie der Zeichenkette zurück, bei der führende und nachfolgende Zeichen entfernt sind. Wird chars weggelassen oder ist None, wird Leerraum entfernt; andernfalls wird chars als Menge der zu entfernenden Zeichen behandelt.

upper() → str¶: Gibt eine Kopie der Zeichenkette zurück, bei der alle Zeichen in Großbuchstaben umgewandelt sind.

sum(iterable: Iterable[Any], start: Any = 0) → Any¶: Summiert start und die Elemente von iterable von links nach rechts und gibt die Gesamtsumme zurück.

super(type: type | None = None, obj_or_type: Any | None = None) → Any¶: Gibt ein Proxy-Objekt zurück, das Methodenaufrufe an eine Eltern- oder Geschwisterklasse von type delegiert. Nützlich, um auf geerbte Methoden zuzugreifen, die in einer Klasse überschrieben wurden.

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

Erzeugt ein neues Tupel, optional gefüllt mit Elementen aus iterable. Tupel sind unveränderbare Folgen.

count(value: Any) → int¶: Gibt die Anzahl der Elemente im Tupel zurück, die gleich value sind.

index(value: Any, start: int = 0, stop: int = -1) → int¶: Gibt den Index des ersten Elements zurück, das gleich value ist, wobei der Slice [start:stop] durchsucht wird. Löst ValueError aus, wenn value nicht vorhanden ist.

type(obj: Any) → type¶: Mit einem Argument wird der Typ von obj zurückgegeben. Der zurückgegebene Wert ist ein Typ-Objekt.

zip(*iterables: Iterable[Any]) → Iterator[tuple]¶: Gibt einen Iterator von Tupeln zurück, wobei das i-te Tupel das i-te Element aus jedem der Argument-Iterables enthält. Die Iteration stoppt, wenn das kürzeste Eingabe-Iterable erschöpft ist.

Ausnahmen¶

exception AssertionError¶: Wird ausgelöst, wenn eine assert-Anweisung fehlschlägt.

exception AttributeError¶: Wird ausgelöst, wenn eine Attributreferenz oder -zuweisung fehlschlägt.

exception Exception¶: Gemeinsame Basisklasse für alle Ausnahmen, die nicht zum Beenden des Systems führen.

exception ImportError¶: Wird ausgelöst, wenn eine import-Anweisung die Moduldefinition nicht findet.

exception IndexError¶: Wird ausgelöst, wenn ein Folgenindex außerhalb des Bereichs liegt.

exception KeyboardInterrupt¶

Wird ausgelöst, wenn der Benutzer die Programmausführung unterbricht, üblicherweise durch Drücken von Ctrl+C in der REPL.

Siehe auch im Zusammenhang mit Soft Bricking (Boot-Fehler).

exception KeyError¶: Wird ausgelöst, wenn ein Mapping-Schlüssel (Dictionary-Schlüssel) nicht in der Menge der vorhandenen Schlüssel gefunden wird.

exception MemoryError¶: Wird ausgelöst, wenn einer Operation der Speicher ausgeht.

exception NameError¶: Wird ausgelöst, wenn ein lokaler oder globaler Name nicht gefunden wird.

exception NotImplementedError¶: Wird ausgelöst, wenn eine abstrakte Methode oder ein nicht implementiertes Feature aufgerufen wird.

exception OSError¶: Wird ausgelöst, wenn eine Systemfunktion einen systembezogenen Fehler zurückgibt.

exception RuntimeError¶: Wird ausgelöst, wenn ein Fehler erkannt wird, der in keine der anderen Kategorien fällt.

exception StopIteration¶: Wird von next() und der __next__()-Methode eines Iterators ausgelöst, um zu signalisieren, dass keine weiteren Elemente vorhanden sind.

exception SyntaxError¶: Wird ausgelöst, wenn der Parser einen Syntaxfehler erkennt.

exception SystemExit¶

Wird von sys.exit() ausgelöst, um die Beendigung des Interpreters anzufordern. Anders als die meisten Ausnahmen erzeugt sie keinen Traceback, wenn sie nicht abgefangen wird.

Auf der OpenMV Cam verursacht ein nicht behandeltes SystemExit derzeit einen Soft-Reset von MicroPython.

exception TypeError¶: Wird ausgelöst, wenn eine Operation oder Funktion auf ein Objekt eines ungeeigneten Typs angewendet wird.

exception ValueError¶: Wird ausgelöst, wenn eine eingebaute Operation oder Funktion ein Argument des richtigen Typs, aber mit einem ungeeigneten Wert erhält.

exception ZeroDivisionError¶: Wird ausgelöst, wenn das zweite Argument einer Divisions- oder Modulo-Operation null ist.

builtins — eingebaute Funktionen und Ausnahmen¶

Funktionen und Typen¶

Ausnahmen¶

`builtins` — eingebaute Funktionen und Ausnahmen¶