builtins — ingebouwde functies en uitzonderingen

Alle ingebouwde functies en uitzonderingen worden hier beschreven. Ze zijn ook beschikbaar via de builtins-module.

Functies en types

abs(x: Any) Any

Geef de absolute waarde van een getal terug. Het argument mag een integer, een float of een willekeurig object zijn dat __abs__() implementeert.

all(iterable: Iterable[Any]) bool

Geef True terug als alle elementen van iterable waarheidsgetrouw zijn (of als de iterable leeg is).

any(iterable: Iterable[Any]) bool

Geef True terug als een willekeurig element van iterable waarheidsgetrouw is. Geeft False terug als de iterable leeg is.

bin(x: int) str

Converteer een integer naar een binaire string met het voorvoegsel "0b". Het argument moet een Python-integer zijn of __index__() implementeren.

class bool(x: Any = False)

Geef een booleaanse waarde terug, d.w.z. True of False. x wordt geconverteerd met de standaard waarheidstestprocedure.

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

Veranderbare reeks van integers in het bereik 0-255. Constructie volgt dezelfde regels als bytes: vanuit een integer (waarmee een met nullen gevulde buffer van die grootte wordt aangemaakt), een iterable van ints, een string met encoding, of een willekeurig object dat het bufferprotocol ondersteunt. Ondersteunt de standaard reeksbewerkingen plus wijziging op de plaats zelf.

classmethod fromhex(string: str) bytearray

Construeer een bytearray uit een string van hexadecimale cijferparen. Witruimte tussen cijferparen wordt overgeslagen; een niet-hexadecimaal teken veroorzaakt een ValueError.

append(val: int) None

Voeg een enkele waarde (een integer in het bereik 0-255) toe aan het einde van de bytearray, waarmee deze met een byte groeit.

center(width: int, fillbyte: bytes) bytes

Geef een kopie van de inhoud terug, gecentreerd in een reeks van lengte width, opgevuld met fillbyte. In tegenstelling tot CPython is fillbyte verplicht. De gegevens worden ongewijzigd teruggegeven wanneer width niet groter is dan de huidige lengte.

count(sub: bytes, start: int = 0, end: int = -1) int

Geef het aantal niet-overlappende voorkomens van sub terug in de slice [start:end].

endswith(suffix: bytes, start: int = 0, end: int = -1) bool

Geef True terug als de inhoud eindigt met suffix. In tegenstelling tot CPython kan suffix geen tupel van waarden zijn.

extend(iterable: Iterable[int]) None

Voeg alle items uit iterable toe aan het einde van de bytearray. Als uitbreiding op CPython mag elk object dat het bufferprotocol ondersteunt worden gebruikt.

find(sub: bytes, start: int = 0, end: int = -1) int

Geef de laagste index terug waar sub wordt gevonden binnen de slice [start:end], of -1 als deze niet wordt gevonden.

format(*args: Any, **kwargs: Any) str

Voer een stringopmaakbewerking uit met de inhoud als opmaakstring en geef het opgemaakte resultaat terug.

hex(sep: str = '') str

Geef een string terug van twee hexadecimale cijfers voor elke byte. Als de optionele sep (een string met lengte 1) wordt opgegeven, wordt deze tussen opeenvolgende bytewaarden ingevoegd.

index(sub: bytes, start: int = 0, end: int = -1) int

Zoals find(), maar veroorzaak een ValueError wanneer sub niet wordt gevonden.

isalpha() bool

Geef True terug als alle bytes alfabetische ASCII-tekens zijn en er ten minste één byte is, anders False.

isdigit() bool

Geef True terug als alle bytes ASCII-decimale cijfers zijn en er ten minste één byte is, anders False.

islower() bool

Geef True terug als alle bytes met hoofdletter/kleine letter onderscheid kleine letters zijn en er ten minste één zo’n byte is, anders False.

isspace() bool

Geef True terug als alle bytes ASCII-witruimte zijn en er ten minste één byte is, anders False.

isupper() bool

Geef True terug als alle bytes met hoofdletter/kleine letter onderscheid hoofdletters zijn en er ten minste één zo’n byte is, anders False.

join(iterable: Iterable[bytes]) bytes

Geef een bytes-object terug dat de samenvoeging is van de items in iterable, waarbij de inhoud van de bytearray als scheidingsteken wordt gebruikt.

lower() bytes

Geef een kopie van de inhoud terug waarin alle ASCII-hoofdletters zijn omgezet naar kleine letters.

lstrip(chars: bytes | None = None) bytes

Geef een kopie terug met voorafgaande bytes verwijderd. chars specificeert de verzameling te verwijderen bytes; indien weggelaten of None, wordt ASCII-witruimte verwijderd.

partition(sep: bytes) tuple

Splits bij het eerste voorkomen van sep en geef (head, sep, tail) terug. Als sep niet wordt gevonden, geef dan de inhoud gevolgd door twee lege objecten terug.

replace(old: bytes, new: bytes, count: int = -1) bytes

Geef een kopie terug waarin alle voorkomens van old zijn vervangen door new. Als count wordt opgegeven, worden alleen de eerste count voorkomens vervangen.

rfind(sub: bytes, start: int = 0, end: int = -1) int

Geef de hoogste index terug waar sub wordt gevonden binnen de slice [start:end], of -1 als deze niet wordt gevonden.

rindex(sub: bytes, start: int = 0, end: int = -1) int

Zoals rfind(), maar veroorzaak een ValueError wanneer sub niet wordt gevonden.

rpartition(sep: bytes) tuple

Splits bij het laatste voorkomen van sep en geef (head, sep, tail) terug. Als sep niet wordt gevonden, geef dan twee lege objecten gevolgd door de inhoud terug.

rsplit(sep: bytes | None = None, maxsplit: int = -1) list

Splits bij voorkomens van sep in een lijst van stukken, waarbij ten hoogste maxsplit splitsingen worden uitgevoerd, geteld vanaf rechts. Als sep None is of wordt weggelaten, splits dan op reeksen van ASCII-witruimte.

rstrip(chars: bytes | None = None) bytes

Geef een kopie terug met afsluitende bytes verwijderd. chars specificeert de verzameling te verwijderen bytes; indien weggelaten of None, wordt ASCII-witruimte verwijderd.

split(sep: bytes | None = None, maxsplit: int = -1) list

Splits bij voorkomens van sep in een lijst van stukken. Als sep None is of wordt weggelaten, splits dan op reeksen van ASCII-witruimte en wordt voorafgaande/afsluitende witruimte genegeerd.

splitlines(keepends: bool = False) list

Geef een lijst van de regels terug, waarbij wordt afgebroken bij \n, \r en \r\n. Regeleinden worden uitgesloten tenzij keepends waar is.

startswith(prefix: bytes, start: int = 0, end: int = -1) bool

Geef True terug als de inhoud begint met prefix. In tegenstelling tot CPython kan prefix geen tupel zijn, en end wordt geaccepteerd maar genegeerd.

strip(chars: bytes | None = None) bytes

Geef een kopie terug met voorafgaande en afsluitende bytes verwijderd. chars specificeert de verzameling te verwijderen bytes; indien weggelaten of None, wordt ASCII-witruimte verwijderd.

upper() bytes

Geef een kopie van de inhoud terug waarin alle ASCII-kleine letters zijn omgezet naar hoofdletters.

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

Onveranderbare reeks van integers in het bereik 0-255. Aangemaakt vanuit een integer (met nullen gevulde buffer), een iterable van ints, een string met encoding, of een willekeurig object dat het bufferprotocol ondersteunt. Bytes-literals gebruiken de b'...'-syntaxis.

classmethod fromhex(string: str) bytes

Construeer een bytes-object uit een string van hexadecimale cijferparen. Witruimte tussen cijferparen wordt overgeslagen; een niet-hexadecimaal teken veroorzaakt een ValueError.

center(width: int, fillbyte: bytes) bytes

Geef een kopie terug, gecentreerd in een reeks van lengte width, opgevuld met fillbyte (een bytes met lengte 1 die de opvulbyte aangeeft). In tegenstelling tot CPython is fillbyte verplicht. Het oorspronkelijke object wordt ongewijzigd teruggegeven wanneer width niet groter is dan de lengte ervan.

count(sub: bytes, start: int = 0, end: int = -1) int

Geef het aantal niet-overlappende voorkomens van sub terug in de slice [start:end].

decode(encoding: str = 'utf-8') str

Geef een str terug die gedecodeerd is uit de bytes. In MicroPython wordt het encoding-argument geaccepteerd maar in feite genegeerd (de bytes worden geherinterpreteerd als UTF-8).

endswith(suffix: bytes, start: int = 0, end: int = -1) bool

Geef True terug als de bytes eindigen met suffix. In tegenstelling tot CPython kan suffix geen tupel van te proberen waarden zijn.

find(sub: bytes, start: int = 0, end: int = -1) int

Geef de laagste index terug waar de deelreeks sub wordt gevonden binnen de slice [start:end], of -1 als deze niet wordt gevonden.

format(*args: Any, **kwargs: Any) str

Voer een stringopmaakbewerking uit met de bytes als opmaakstring en geef het opgemaakte resultaat terug.

hex(sep: str = '') str

Geef een string terug van twee hexadecimale cijfers voor elke byte. Als de optionele sep (een string met lengte 1) wordt opgegeven, wordt deze tussen opeenvolgende bytewaarden ingevoegd.

index(sub: bytes, start: int = 0, end: int = -1) int

Zoals find(), maar veroorzaak een ValueError wanneer sub niet wordt gevonden.

isalpha() bool

Geef True terug als alle bytes alfabetische ASCII-tekens zijn en er ten minste één byte is, anders False.

isdigit() bool

Geef True terug als alle bytes ASCII-decimale cijfers zijn en er ten minste één byte is, anders False.

islower() bool

Geef True terug als alle bytes met hoofdletter/kleine letter onderscheid kleine letters zijn en er ten minste één zo’n byte is, anders False.

isspace() bool

Geef True terug als alle bytes ASCII-witruimte zijn en er ten minste één byte is, anders False.

isupper() bool

Geef True terug als alle bytes met hoofdletter/kleine letter onderscheid hoofdletters zijn en er ten minste één zo’n byte is, anders False.

join(iterable: Iterable[bytes]) bytes

Geef een bytes-object terug dat de samenvoeging is van de items in iterable, waarbij het bytes-object zelf als scheidingsteken wordt gebruikt.

lower() bytes

Geef een kopie terug waarin alle ASCII-hoofdletters zijn omgezet naar kleine letters.

lstrip(chars: bytes | None = None) bytes

Geef een kopie terug met voorafgaande bytes verwijderd. chars specificeert de verzameling te verwijderen bytes; indien weggelaten of None, wordt ASCII-witruimte verwijderd.

partition(sep: bytes) tuple

Splits bij het eerste voorkomen van sep en geef (head, sep, tail) terug. Als sep niet wordt gevonden, geef dan de bytes gevolgd door twee lege bytes-objecten terug.

replace(old: bytes, new: bytes, count: int = -1) bytes

Geef een kopie terug waarin alle voorkomens van old zijn vervangen door new. Als count wordt opgegeven, worden alleen de eerste count voorkomens vervangen.

rfind(sub: bytes, start: int = 0, end: int = -1) int

Geef de hoogste index terug waar sub wordt gevonden binnen de slice [start:end], of -1 als deze niet wordt gevonden.

rindex(sub: bytes, start: int = 0, end: int = -1) int

Zoals rfind(), maar veroorzaak een ValueError wanneer sub niet wordt gevonden.

rpartition(sep: bytes) tuple

Splits bij het laatste voorkomen van sep en geef (head, sep, tail) terug. Als sep niet wordt gevonden, geef dan twee lege bytes-objecten gevolgd door de bytes terug.

rsplit(sep: bytes | None = None, maxsplit: int = -1) list

Splits bij voorkomens van sep in een lijst van stukken, waarbij ten hoogste maxsplit splitsingen worden uitgevoerd, geteld vanaf rechts. Als sep None is of wordt weggelaten, splits dan op reeksen van ASCII-witruimte.

rstrip(chars: bytes | None = None) bytes

Geef een kopie terug met afsluitende bytes verwijderd. chars specificeert de verzameling te verwijderen bytes; indien weggelaten of None, wordt ASCII-witruimte verwijderd.

split(sep: bytes | None = None, maxsplit: int = -1) list

Splits bij voorkomens van sep in een lijst van stukken. Als sep None is of wordt weggelaten, splits dan op reeksen van ASCII-witruimte en wordt voorafgaande/afsluitende witruimte genegeerd.

splitlines(keepends: bool = False) list

Geef een lijst van de regels terug, waarbij wordt afgebroken bij \n, \r en \r\n. Regeleinden worden uitgesloten tenzij keepends waar is.

startswith(prefix: bytes, start: int = 0, end: int = -1) bool

Geef True terug als de bytes beginnen met prefix. In tegenstelling tot CPython kan prefix geen tupel zijn, en end wordt geaccepteerd maar genegeerd.

strip(chars: bytes | None = None) bytes

Geef een kopie terug met voorafgaande en afsluitende bytes verwijderd. chars specificeert de verzameling te verwijderen bytes; indien weggelaten of None, wordt ASCII-witruimte verwijderd.

upper() bytes

Geef een kopie terug waarin alle ASCII-kleine letters zijn omgezet naar hoofdletters.

callable(obj: Any) bool

Geef True terug als obj aanroepbaar lijkt, anders False.

chr(i: int) str

Geef een string van één teken terug waarvan het Unicode-codepunt de integer i is.

classmethod(func: Callable[..., Any]) classmethod

Transformeer een methode in een klassemethode. Meestal gebruikt als decorator.

compile(source: str | bytes, filename: str, mode: str) Any

Compileer source in een code-object dat kan worden uitgevoerd door exec() of eval(). mode is een van "exec", "eval" of "single".

class complex(real: float | str = 0, imag: float = 0)

Maak een complex getal vanuit een reëel en imaginair deel, of vanuit een string.

delattr(obj, name: str) None

Het argument name moet een string zijn, en deze functie verwijdert het genoemde attribuut van het object dat door obj wordt gegeven.

class dict(*args, **kwargs)

Maak een nieuw dictionary. Equivalent aan CPython’s dict.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) dict

Maak een nieuw dictionary met sleutels overgenomen uit iterable, elk gekoppeld aan value (standaard None). Aangeroepen op het type, bijv. dict.fromkeys(...).

clear() None

Verwijder alle items uit het dictionary, zodat het leeg blijft. Veroorzaakt een TypeError als het dictionary vast is (alleen-lezen).

copy() dict

Geef een ondiepe kopie van het dictionary terug. Het teruggegeven object heeft hetzelfde type als het origineel (dict of OrderedDict) maar is niet vast.

get(key: Any, default: Any = None) Any

Geef de waarde voor key terug als deze in het dictionary staat, geef anders default terug (die zelf standaard None is, zodat dit nooit een KeyError veroorzaakt). Het dictionary wordt niet gewijzigd.

items() Any

Geef een dynamisch view-object terug over de (key, value)-paren dat latere wijzigingen aan het dictionary weergeeft en iteratie, len(), de in-operator en verzameling-vergelijkingsoperatoren ondersteunt.

keys() Any

Geef een dynamisch view-object terug over de sleutels dat latere wijzigingen aan het dictionary weergeeft en iteratie, len(), de in-operator en verzameling-vergelijkingsoperatoren ondersteunt.

pop(key: Any, default: Any = None) Any

Verwijder key uit het dictionary en geef de waarde ervan terug. Als key niet aanwezig is, geef dan default terug als die was opgegeven; veroorzaak anders een KeyError. Veroorzaakt een TypeError als het dictionary vast is.

popitem() tuple

Verwijder een willekeurig (key, value)-paar en geef het terug als een 2-tupel. Voor een gewoon dict is het gekozen paar niet gespecificeerd; voor een OrderedDict wordt het laatst ingevoegde paar verwijderd (LIFO). Veroorzaakt een KeyError als het dictionary leeg is, of een TypeError als het vast is.

setdefault(key: Any, default: Any = None) Any

Als key in het dictionary staat, geef dan de waarde ervan terug. Voeg anders key in met de waarde default (standaard None) en geef die waarde terug. Veroorzaakt een TypeError als het dictionary vast is.

update(*args: Any, **kwargs: Any) None

Werk het dictionary op de plaats zelf bij. Er wordt ten hoogste één positioneel argument geaccepteerd: ofwel een ander dictionary, ofwel een iterable van tweedelige (key, value)-paren (elk moet precies twee items opleveren, anders wordt een ValueError veroorzaakt). Sleutelwoordargumenten worden vervolgens toegevoegd als items met string-sleutels. Bestaande sleutels worden overschreven. Veroorzaakt een TypeError als het dictionary vast is.

values() Any

Geef een dynamisch view-object terug over de waarden dat latere wijzigingen aan het dictionary weergeeft en iteratie en len() ondersteunt.

__getitem__(key: Any) Any

Geef self[key] terug. Implementeert de indexeringsoperator d[key]; veroorzaakt een KeyError als key niet aanwezig is.

__setitem__(key: Any, value: Any) None

Stel self[key] in op value. Implementeert d[key] = value.

__delitem__(key: Any) None

Verwijder self[key]. Implementeert del d[key]; veroorzaakt een KeyError als key niet aanwezig is.

dir(obj: Any = None) list

Zonder argumenten, geef de lijst van namen in het huidige lokale bereik terug. Met een argument, geef een lijst van geldige attributen voor dat object terug.

divmod(a: Any, b: Any) tuple

Geef het paar (a // b, a % b) terug als een tupel, voor twee (niet-complexe) getallen.

enumerate(iterable: Iterable[Any], start: int = 0) Iterator[tuple]

Geef een enumerate-object terug dat (index, value)-paren oplevert uit iterable, waarbij de index begint bij start.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) Any

Evalueer een Python-expressie die als string (of gecompileerd code-object) is gegeven en geef het resultaat terug.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) None

Voer Python-code die als string of gecompileerd code-object is verstrekt dynamisch uit.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) Iterator[Any]

Construeer een iterator uit die elementen van iterable waarvoor function waar teruggeeft. Als function None is, wordt de identiteitsfunctie aangenomen.

class float(x: str | bytes | int | float = 0.0)

Geef een drijvendekommagetal terug dat is geconstrueerd uit een getal of string x.

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

Geef een nieuw frozenset-object terug, optioneel met elementen overgenomen uit iterable. frozenset is een onveranderbare, hashbare variant van set.

copy() frozenset

Geef een ondiepe kopie van het frozenset terug.

difference(*others: Iterable[Any]) frozenset

Geef een nieuw frozenset terug met elementen uit het frozenset die in geen van others voorkomen. Elk argument mag een willekeurige iterable zijn.

intersection(other: Iterable[Any]) frozenset

Geef een nieuw frozenset terug met elementen die het frozenset en other gemeen hebben. In MicroPython wordt slechts één other-argument geaccepteerd (CPython accepteert er meerdere).

isdisjoint(other: Iterable[Any]) bool

Geef True terug als het frozenset geen elementen gemeen heeft met other.

issubset(other: Iterable[Any]) bool

Geef True terug als elk element van het frozenset in other zit.

issuperset(other: Iterable[Any]) bool

Geef True terug als elk element van other in het frozenset zit.

symmetric_difference(other: Iterable[Any]) frozenset

Geef een nieuw frozenset terug met elementen die in ofwel het frozenset ofwel other zitten maar niet in beide. In MicroPython wordt slechts één other-argument geaccepteerd.

union(other: Iterable[Any]) frozenset

Geef een nieuw frozenset terug met elementen uit het frozenset en other. In MicroPython wordt slechts één other-argument geaccepteerd (CPython accepteert er meerdere).

getattr(obj: Any, name: str, default: Any = None) Any

Geef de waarde van het genoemde attribuut van obj terug. Als het attribuut niet bestaat, wordt default teruggegeven indien opgegeven, anders wordt een AttributeError veroorzaakt.

globals() dict

Geef een dictionary terug dat de globale symbooltabel van de huidige module weergeeft.

hasattr(obj: Any, name: str) bool

Geef True terug als obj een attribuut met de gegeven name heeft, anders False.

hash(obj: Any) int

Geef de hash-waarde van obj terug (als deze er een heeft). Hash-waarden zijn integers die worden gebruikt om dictionary-sleutels snel te vergelijken tijdens een dictionary-opzoeking.

hex(x: int) str

Converteer een integer naar een hexadecimale string met kleine letters en het voorvoegsel "0x".

id(obj: Any) int

Geef de identiteit van een object terug. Dit is een integer die gegarandeerd uniek en constant is voor dit object gedurende zijn levensduur.

input(prompt: str = '') str

Lees een regel uit standaardinvoer en geef deze terug als string (zonder afsluitende nieuwe regel). Als prompt wordt opgegeven, wordt deze eerst zonder afsluitende nieuwe regel naar standaarduitvoer geschreven.

class int(x: str | bytes | int | float = 0, base: int = 10)
classmethod from_bytes(bytes: bytes, byteorder: str) int

In MicroPython moet de byteorder-parameter positioneel zijn (dit is compatibel met CPython).

to_bytes(size: int, byteorder: str) bytes

In MicroPython moet de byteorder-parameter positioneel zijn (dit is compatibel met CPython).

Notitie

Het optionele signed sleutelwoordargument van CPython wordt niet ondersteund. MicroPython converteert negatieve integers momenteel als signed en positieve als unsigned. (Details.)

isinstance(obj: Any, classinfo: type | tuple) bool

Geef True terug als obj een instantie is van classinfo of een van zijn subklassen. classinfo mag een klasse of een tupel van klassen zijn.

issubclass(cls: type, classinfo: type | tuple) bool

Geef True terug als cls een subklasse (direct, indirect of virtueel) van classinfo is.

iter(obj: Any, sentinel: Any = None) Iterator[Any]

Geef een iterator-object terug. Met één argument moet obj het iteratieprotocol ondersteunen. Met twee argumenten moet obj aanroepbaar zijn en stopt de iteratie wanneer deze sentinel teruggeeft.

len(obj: Any) int

Geef het aantal items in een container terug.

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

Bouw een nieuwe lijst, optioneel gevuld met items uit iterable.

append(object: Any) None

Voeg object toe aan het einde van de lijst.

clear() None

Verwijder alle items uit de lijst, zodat deze leeg blijft.

copy() list

Geef een ondiepe kopie van de lijst terug.

count(value: Any) int

Geef het aantal elementen in de lijst terug dat gelijk is aan value.

extend(iterable: Iterable[Any]) None

Voeg alle items uit iterable toe aan het einde van de lijst. Als iterable zelf een lijst is, worden de items ervan direct gekopieerd; anders wordt eroverheen geïtereerd.

index(value: Any, start: int = 0, stop: int = -1) int

Geef de index van het eerste element terug dat gelijk is aan value, zoekend in de slice [start:stop]. Veroorzaakt een ValueError als value niet aanwezig is.

insert(index: int, object: Any) None

Voeg object in vóór positie index. Een negatieve index wordt geïnterpreteerd ten opzichte van het einde van de lijst, en de index wordt vastgeklemd binnen het geldige bereik (zodat waarden voorbij beide uiteinden aan het begin of einde invoegen).

pop(index: int = -1) Any

Verwijder het item op index en geef het terug (standaard het laatste item). Veroorzaakt een IndexError als de lijst leeg is of index buiten bereik valt.

remove(value: Any) None

Verwijder het eerste element dat gelijk is aan value. Veroorzaakt een ValueError als value niet aanwezig is.

reverse() None

Keer de items van de lijst op de plaats zelf om.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) None

Sorteer de items van de lijst op de plaats zelf. key en reverse zijn alleen via sleutelwoord. key, indien opgegeven, is een functie die op elk element wordt toegepast om de vergelijkingswaarde te produceren; reverse sorteert in aflopende volgorde.

Notitie

In tegenstelling tot CPython is de sortering van MicroPython-lijsten niet stabiel.

locals() dict

Geef een dictionary terug dat de huidige lokale symbooltabel weergeeft.

map(function: Callable[..., Any], *iterables: Iterable[Any]) Iterator[Any]

Geef een iterator terug die function toepast op elk item van iterables en de resultaten oplevert.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) Any

Met één iterable-argument, geef het grootste item ervan terug. Met twee of meer argumenten, geef het grootste argument terug.

class memoryview(obj: Any)

Maak een memoryview die verwijst naar obj, dat het bufferprotocol moet ondersteunen (bijv. bytes, bytearray, array.array). Maakt zero-copy toegang tot en slicing van het onderliggende geheugen mogelijk; het slicen van een memoryview geeft een andere memoryview terug in plaats van een kopie.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) Any

Met één iterable-argument, geef het kleinste item ervan terug. Met twee of meer argumenten, geef het kleinste argument terug.

next(iterator: Iterator[Any], default: Any = None) Any

Haal het volgende item op uit iterator. Als default wordt opgegeven en de iterator uitgeput is, wordt default teruggegeven in plaats van een StopIteration te veroorzaken.

class object

Geef een nieuw kenmerkloos object terug. object is de basisklasse voor alle klassen.

oct(x: int) str

Converteer een integer naar een octale string met het voorvoegsel "0o".

open(file: str, mode: str = 'r', **kwargs) Any

Open file en geef een bijbehorend bestandsobject terug. mode is standaard "r" voor tekstlezen.

ord(c: str) int

Geef het Unicode-codepunt van een string met één teken c terug als integer.

pow(base: Any, exp: Any, mod: Any | None = None) Any

Geef base tot de macht exp terug. Als mod wordt opgegeven, geef base ** exp % mod terug (efficiënter berekend dan de expliciete vorm).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) None

Druk objects af naar de tekststroom file, gescheiden door sep en gevolgd door 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

Geef een property-attribuut terug. Meestal gebruikt als decorator om beheerde attributen op een klasse te definiëren.

range(*args: int) range

Geef een onveranderbare reeks van integers terug. Aangeroepen als range(stop), range(start, stop) of range(start, stop, step).

repr(obj: Any) str

Geef een string terug die een afdrukbare weergave van obj bevat.

reversed(seq: Any) Iterator[Any]

Geef een omgekeerde iterator terug over de waarden van de gegeven reeks.

round(number: Any, ndigits: int | None = None) Any

Geef number afgerond op ndigits decimalen terug. Als ndigits wordt weggelaten, geef het dichtstbijzijnde gehele getal terug.

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

Geef een nieuw set-object terug, optioneel met elementen overgenomen uit iterable.

add(elem: Any) None

Voeg element elem toe aan de set.

clear() None

Verwijder alle elementen uit de set.

copy() set

Geef een ondiepe kopie van de set terug.

difference(*others: Iterable[Any]) set

Geef een nieuwe set terug met elementen uit de set die in geen van others voorkomen. Elk argument mag een willekeurige iterable zijn.

difference_update(*others: Iterable[Any]) None

Verwijder uit de set alle elementen die in een van others voorkomen (op de plaats zelf).

discard(elem: Any) None

Verwijder element elem uit de set als het aanwezig is. In tegenstelling tot remove() veroorzaakt dit geen fout als elem afwezig is.

intersection(other: Iterable[Any]) set

Geef een nieuwe set terug met elementen die de set en other gemeen hebben. In MicroPython wordt slechts één other-argument geaccepteerd (CPython accepteert er meerdere).

intersection_update(other: Iterable[Any]) None

Werk de set bij, waarbij alleen elementen worden behouden die ook in other voorkomen (op de plaats zelf). In MicroPython wordt slechts één other-argument geaccepteerd.

isdisjoint(other: Iterable[Any]) bool

Geef True terug als de set geen elementen gemeen heeft met other.

issubset(other: Iterable[Any]) bool

Geef True terug als elk element van de set in other zit.

issuperset(other: Iterable[Any]) bool

Geef True terug als elk element van other in de set zit.

pop() Any

Verwijder een willekeurig element uit de set en geef het terug. Veroorzaakt een KeyError als de set leeg is.

remove(elem: Any) None

Verwijder element elem uit de set. Veroorzaakt een KeyError als elem niet in de set zit.

symmetric_difference(other: Iterable[Any]) set

Geef een nieuwe set terug met elementen die in ofwel de set ofwel other zitten maar niet in beide. In MicroPython wordt slechts één other-argument geaccepteerd.

symmetric_difference_update(other: Iterable[Any]) None

Werk de set bij, waarbij alleen elementen worden behouden die in ofwel de set ofwel other zitten maar niet in beide (op de plaats zelf). In MicroPython wordt slechts één other-argument geaccepteerd.

union(other: Iterable[Any]) set

Geef een nieuwe set terug met elementen uit de set en other. In MicroPython wordt slechts één other-argument geaccepteerd (CPython accepteert er meerdere).

update(*others: Iterable[Any]) None

Werk de set bij door elementen uit alle others toe te voegen (op de plaats zelf).

setattr(obj: Any, name: str, value: Any) None

Stel het genoemde attribuut op obj in op value. De tegenhanger van getattr().

class slice

De ingebouwde slice is het type dat slice-objecten hebben.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) list

Geef een nieuwe gesorteerde lijst terug van de items in iterable.

staticmethod(func: Callable[..., Any]) staticmethod

Transformeer een methode in een statische methode. Meestal gebruikt als decorator.

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

Geef een stringversie van object terug. Als object een bytes-achtig object is, sturen de argumenten encoding en errors het decoderen aan.

center(width: int) str

Geef een kopie van de string terug, gecentreerd in een veld van lengte width, opgevuld met spaties. In MicroPython wordt alleen een spatie als opvulteken gebruikt (er is geen opvultekenargument), en de oorspronkelijke string wordt ongewijzigd teruggegeven wanneer width niet groter is dan de lengte ervan.

count(sub: str, start: int = 0, end: int = -1) int

Geef het aantal niet-overlappende voorkomens van sub terug in de slice [start:end]. Een lege sub telt elke spleet tussen tekens.

encode(encoding: str = 'utf-8', errors: str = 'strict') bytes

Geef een bytes-object terug dat de string codeert. MicroPython negeert de argumenten in feite en gebruikt UTF-8; errors wordt geaccepteerd maar er wordt niets mee gedaan. Equivalent aan bytes(s, "utf-8").

endswith(suffix: str | tuple, start: int = 0, end: int = -1) bool

Geef True terug als de string eindigt met de gegeven suffix, die een enkele string of een tupel van te proberen strings mag zijn. Optionele start en end beperken de vergelijking tot de slice [start:end].

find(sub: str, start: int = 0, end: int = -1) int

Geef de laagste index in de string terug waar deelstring sub wordt gevonden binnen de slice [start:end], of -1 als deze niet wordt gevonden.

format(*args: Any, **kwargs: Any) str

Voer een stringopmaakbewerking uit, waarbij vervangingsvelden afgebakend door accolades {} worden vervangen door waarden uit args en kwargs. Ondersteunt de standaard mini-taal voor opmaakspecificaties.

index(sub: str, start: int = 0, end: int = -1) int

Zoals find(), maar veroorzaak een ValueError wanneer de deelstring sub niet wordt gevonden in de slice [start:end].

isalpha() bool

Geef True terug als alle tekens in de string alfabetisch zijn en de string niet leeg is, anders False.

isdigit() bool

Geef True terug als alle tekens in de string cijfers zijn en de string niet leeg is, anders False.

islower() bool

Geef True terug als de string ten minste één alfabetisch teken bevat en al die tekens kleine letters zijn, anders False.

isspace() bool

Geef True terug als alle tekens in de string witruimte zijn en de string niet leeg is, anders False.

isupper() bool

Geef True terug als de string ten minste één alfabetisch teken bevat en al die tekens hoofdletters zijn, anders False.

join(iterable: Iterable[str]) str

Voeg de strings in iterable samen, waarbij deze string als scheidingsteken tussen elementen wordt ingevoegd. Items moeten strings zijn, anders wordt een TypeError veroorzaakt.

lower() str

Geef een kopie van de string terug waarin alle tekens zijn omgezet naar kleine letters.

lstrip(chars: str | None = None) str

Geef een kopie van de string terug met voorafgaande tekens verwijderd. Als chars wordt weggelaten of None is, wordt witruimte verwijderd; anders wordt chars behandeld als een verzameling te verwijderen tekens.

partition(sep: str) tuple

Splits de string bij het eerste voorkomen van sep en geef een 3-tupel (head, sep, tail) terug. Als sep niet wordt gevonden, geef dan (self, "", "") terug. Een lege sep veroorzaakt een ValueError.

replace(old: str, new: str, count: int = -1) str

Geef een kopie van de string terug waarin alle voorkomens van deelstring old zijn vervangen door new. Als count wordt opgegeven en niet-negatief is, worden alleen de eerste count voorkomens vervangen.

rfind(sub: str, start: int = 0, end: int = -1) int

Geef de hoogste index in de string terug waar deelstring sub wordt gevonden binnen de slice [start:end], of -1 als deze niet wordt gevonden.

rindex(sub: str, start: int = 0, end: int = -1) int

Zoals rfind(), maar veroorzaak een ValueError wanneer de deelstring sub niet wordt gevonden in de slice [start:end].

rpartition(sep: str) tuple

Splits de string bij het laatste voorkomen van sep en geef een 3-tupel (head, sep, tail) terug. Als sep niet wordt gevonden, geef dan ("", "", self) terug. Een lege sep veroorzaakt een ValueError.

rsplit(sep: str | None = None, maxsplit: int = -1) list

Splits de string vanaf rechts in een lijst van deelstrings met sep als scheidingsteken, waarbij ten hoogste maxsplit splitsingen worden uitgevoerd. Zonder maxsplit (of een negatieve) gedraagt het zich identiek aan split(); in MicroPython veroorzaakt rsplit(None, n) met een niet-negatieve n een NotImplementedError.

rstrip(chars: str | None = None) str

Geef een kopie van de string terug met afsluitende tekens verwijderd. Als chars wordt weggelaten of None is, wordt witruimte verwijderd; anders wordt chars behandeld als een verzameling te verwijderen tekens.

split(sep: str | None = None, maxsplit: int = -1) list

Splits de string in een lijst van deelstrings met sep als scheidingsteken, waarbij ten hoogste maxsplit splitsingen worden uitgevoerd. Als sep wordt weggelaten of None is, splits dan op reeksen van witruimte waarbij voorafgaande witruimte wordt genegeerd; anders veroorzaakt een lege sep een ValueError.

splitlines(keepends: bool = False) list

Geef een lijst van de regels in de string terug, waarbij wordt afgebroken bij \n, \r en \r\n. Regeleinden worden niet opgenomen tenzij keepends waar is.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) bool

Geef True terug als de string begint met de gegeven prefix, die een enkele string of een tupel van te proberen strings mag zijn. Optionele start en end beperken de vergelijking tot de slice [start:end].

strip(chars: str | None = None) str

Geef een kopie van de string terug met voorafgaande en afsluitende tekens verwijderd. Als chars wordt weggelaten of None is, wordt witruimte verwijderd; anders wordt chars behandeld als een verzameling te verwijderen tekens.

upper() str

Geef een kopie van de string terug waarin alle tekens zijn omgezet naar hoofdletters.

sum(iterable: Iterable[Any], start: Any = 0) Any

Tel start en de items van iterable van links naar rechts op, en geef het totaal terug.

super(type: type | None = None, obj_or_type: Any | None = None) Any

Geef een proxy-object terug dat methode-aanroepen delegeert naar een ouder- of zusterklasse van type. Nuttig voor het benaderen van overgeërfde methoden die in een klasse zijn overschreven.

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

Bouw een nieuwe tupel, optioneel gevuld met items uit iterable. Tupels zijn onveranderbare reeksen.

count(value: Any) int

Geef het aantal elementen in de tupel terug dat gelijk is aan value.

index(value: Any, start: int = 0, stop: int = -1) int

Geef de index van het eerste element terug dat gelijk is aan value, zoekend in de slice [start:stop]. Veroorzaakt een ValueError als value niet aanwezig is.

type(obj: Any) type

Met één argument, geef het type van obj terug. De teruggegeven waarde is een type-object.

zip(*iterables: Iterable[Any]) Iterator[tuple]

Geef een iterator van tupels terug, waarbij het i-de tupel het i-de element bevat uit elk van de argument-iterables. De iteratie stopt wanneer de kortste invoer-iterable is uitgeput.

Uitzonderingen

exception AssertionError

Veroorzaakt wanneer een assert-statement mislukt.

exception AttributeError

Veroorzaakt wanneer een attribuutreferentie of -toewijzing mislukt.

exception Exception

Gemeenschappelijke basisklasse voor alle niet-systeembeëindigende uitzonderingen.

exception ImportError

Veroorzaakt wanneer een import-statement de moduledefinitie niet kan vinden.

exception IndexError

Veroorzaakt wanneer een reeks-subscript buiten bereik valt.

exception KeyboardInterrupt

Veroorzaakt wanneer de gebruiker de programma-uitvoering onderbreekt, meestal door op Ctrl+C te drukken in de REPL.

Zie ook in de context van Soft bricking (mislukken van opstarten).

exception KeyError

Veroorzaakt wanneer een mapping-sleutel (dictionary) niet wordt gevonden in de verzameling bestaande sleutels.

exception MemoryError

Veroorzaakt wanneer een bewerking onvoldoende geheugen heeft.

exception NameError

Veroorzaakt wanneer een lokale of globale naam niet wordt gevonden.

exception NotImplementedError

Veroorzaakt wanneer een abstracte methode of een niet-geïmplementeerd kenmerk wordt aangeroepen.

exception OSError

Veroorzaakt wanneer een systeemfunctie een systeemgerelateerde fout teruggeeft.

exception RuntimeError

Veroorzaakt wanneer een fout wordt gedetecteerd die in geen van de andere categorieën valt.

exception StopIteration

Veroorzaakt door next() en de __next__()-methode van een iterator om aan te geven dat er geen verdere items zijn.

exception SyntaxError

Veroorzaakt wanneer de parser een syntaxisfout tegenkomt.

exception SystemExit

Veroorzaakt door sys.exit() om beëindiging van de interpreter aan te vragen. In tegenstelling tot de meeste uitzonderingen produceert het geen traceback wanneer het niet wordt afgevangen.

Op de OpenMV Cam veroorzaakt een niet-afgehandelde SystemExit momenteel een Zachte reset van MicroPython.

exception TypeError

Veroorzaakt wanneer een bewerking of functie wordt toegepast op een object van een ongepast type.

exception ValueError

Veroorzaakt wanneer een ingebouwde bewerking of functie een argument van het juiste type maar met een ongepaste waarde ontvangt.

exception ZeroDivisionError

Veroorzaakt wanneer het tweede argument van een deel- of modulobewerking nul is.