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
Trueterug als alle elementen van iterable waarheidsgetrouw zijn (of als de iterable leeg is).
- any(iterable: Iterable[Any]) bool¶
Geef
Trueterug als een willekeurig element van iterable waarheidsgetrouw is. GeeftFalseterug 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.
TrueofFalse. 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 metencoding, 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
bytearrayuit een string van hexadecimale cijferparen. Witruimte tussen cijferparen wordt overgeslagen; een niet-hexadecimaal teken veroorzaakt eenValueError.
- 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
Trueterug 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-1als 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 eenValueErrorwanneer sub niet wordt gevonden.
- isalpha() bool¶
Geef
Trueterug als alle bytes alfabetische ASCII-tekens zijn en er ten minste één byte is, andersFalse.
- isdigit() bool¶
Geef
Trueterug als alle bytes ASCII-decimale cijfers zijn en er ten minste één byte is, andersFalse.
- islower() bool¶
Geef
Trueterug als alle bytes met hoofdletter/kleine letter onderscheid kleine letters zijn en er ten minste één zo’n byte is, andersFalse.
- isspace() bool¶
Geef
Trueterug als alle bytes ASCII-witruimte zijn en er ten minste één byte is, andersFalse.
- isupper() bool¶
Geef
Trueterug als alle bytes met hoofdletter/kleine letter onderscheid hoofdletters zijn en er ten minste één zo’n byte is, andersFalse.
- 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-1als deze niet wordt gevonden.
- rindex(sub: bytes, start: int = 0, end: int = -1) int¶
Zoals
rfind(), maar veroorzaak eenValueErrorwanneer 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
Noneis 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
Noneis 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,\ren\r\n. Regeleinden worden uitgesloten tenzij keepends waar is.
- startswith(prefix: bytes, start: int = 0, end: int = -1) bool¶
Geef
Trueterug als de inhoud begint met prefix. In tegenstelling tot CPython kan prefix geen tupel zijn, en end wordt geaccepteerd maar genegeerd.
- 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 deb'...'-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 eenValueError.
- 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
strterug 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
Trueterug 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-1als 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 eenValueErrorwanneer sub niet wordt gevonden.
- isalpha() bool¶
Geef
Trueterug als alle bytes alfabetische ASCII-tekens zijn en er ten minste één byte is, andersFalse.
- isdigit() bool¶
Geef
Trueterug als alle bytes ASCII-decimale cijfers zijn en er ten minste één byte is, andersFalse.
- islower() bool¶
Geef
Trueterug als alle bytes met hoofdletter/kleine letter onderscheid kleine letters zijn en er ten minste één zo’n byte is, andersFalse.
- isspace() bool¶
Geef
Trueterug als alle bytes ASCII-witruimte zijn en er ten minste één byte is, andersFalse.
- isupper() bool¶
Geef
Trueterug als alle bytes met hoofdletter/kleine letter onderscheid hoofdletters zijn en er ten minste één zo’n byte is, andersFalse.
- 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-1als deze niet wordt gevonden.
- rindex(sub: bytes, start: int = 0, end: int = -1) int¶
Zoals
rfind(), maar veroorzaak eenValueErrorwanneer 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
Noneis 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
Noneis 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,\ren\r\n. Regeleinden worden uitgesloten tenzij keepends waar is.
- startswith(prefix: bytes, start: int = 0, end: int = -1) bool¶
Geef
Trueterug als de bytes beginnen met prefix. In tegenstelling tot CPython kan prefix geen tupel zijn, en end wordt geaccepteerd maar genegeerd.
- 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()ofeval(). 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
TypeErrorals 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 (
dictofOrderedDict) 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
Noneis, zodat dit nooit eenKeyErrorveroorzaakt). 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(), dein-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(), dein-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 eenTypeErrorals het dictionary vast is.
- popitem() tuple¶
Verwijder een willekeurig
(key, value)-paar en geef het terug als een 2-tupel. Voor een gewoondictis het gekozen paar niet gespecificeerd; voor eenOrderedDictwordt het laatst ingevoegde paar verwijderd (LIFO). Veroorzaakt eenKeyErrorals het dictionary leeg is, of eenTypeErrorals 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 eenTypeErrorals 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 eenValueErrorveroorzaakt). Sleutelwoordargumenten worden vervolgens toegevoegd als items met string-sleutels. Bestaande sleutels worden overschreven. Veroorzaakt eenTypeErrorals 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.
- 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
Noneis, 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.
frozensetis een onveranderbare, hashbare variant vanset.- 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
Trueterug als het frozenset geen elementen gemeen heeft met other.
- issubset(other: Iterable[Any]) bool¶
Geef
Trueterug als elk element van het frozenset in other zit.
- issuperset(other: Iterable[Any]) bool¶
Geef
Trueterug als elk element van other in het frozenset zit.
- 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
AttributeErrorveroorzaakt.
- globals() dict¶
Geef een dictionary terug dat de globale symbooltabel van de huidige module weergeeft.
- hasattr(obj: Any, name: str) bool¶
Geef
Trueterug als obj een attribuut met de gegeven name heeft, andersFalse.
- 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
signedsleutelwoordargument 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
Trueterug 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
Trueterug 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.
- class list(iterable: Iterable[Any] = ())¶
Bouw een nieuwe lijst, optioneel gevuld met items uit iterable.
- 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 eenValueErrorals 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
IndexErrorals de lijst leeg is of index buiten bereik valt.
- remove(value: Any) None¶
Verwijder het eerste element dat gelijk is aan value. Veroorzaakt een
ValueErrorals value niet aanwezig is.
- 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.
- 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
StopIterationte veroorzaken.
- class object¶
Geef een nieuw kenmerkloos object terug.
objectis de basisklasse voor alle klassen.
- open(file: str, mode: str = 'r', **kwargs) Any¶
Open file en geef een bijbehorend bestandsobject terug. mode is standaard
"r"voor tekstlezen.
- pow(base: Any, exp: Any, mod: Any | None = None) Any¶
Geef base tot de macht exp terug. Als mod wordt opgegeven, geef
base ** exp % modterug (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)ofrange(start, stop, step).
- 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.
- 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
Trueterug als de set geen elementen gemeen heeft met other.
- pop() Any¶
Verwijder een willekeurig element uit de set en geef het terug. Veroorzaakt een
KeyErrorals de set leeg is.
- remove(elem: Any) None¶
Verwijder element elem uit de set. Veroorzaakt een
KeyErrorals 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.
- 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 aanbytes(s, "utf-8").
- endswith(suffix: str | tuple, start: int = 0, end: int = -1) bool¶
Geef
Trueterug 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-1als 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 eenValueErrorwanneer de deelstring sub niet wordt gevonden in de slice[start:end].
- isalpha() bool¶
Geef
Trueterug als alle tekens in de string alfabetisch zijn en de string niet leeg is, andersFalse.
- isdigit() bool¶
Geef
Trueterug als alle tekens in de string cijfers zijn en de string niet leeg is, andersFalse.
- islower() bool¶
Geef
Trueterug als de string ten minste één alfabetisch teken bevat en al die tekens kleine letters zijn, andersFalse.
- isspace() bool¶
Geef
Trueterug als alle tekens in de string witruimte zijn en de string niet leeg is, andersFalse.
- isupper() bool¶
Geef
Trueterug als de string ten minste één alfabetisch teken bevat en al die tekens hoofdletters zijn, andersFalse.
- 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
TypeErrorveroorzaakt.
- 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
Noneis, 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 eenValueError.
- 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-1als deze niet wordt gevonden.
- rindex(sub: str, start: int = 0, end: int = -1) int¶
Zoals
rfind(), maar veroorzaak eenValueErrorwanneer 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 eenValueError.
- 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 veroorzaaktrsplit(None, n)met een niet-negatieve n eenNotImplementedError.
- rstrip(chars: str | None = None) str¶
Geef een kopie van de string terug met afsluitende tekens verwijderd. Als chars wordt weggelaten of
Noneis, 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
Noneis, splits dan op reeksen van witruimte waarbij voorafgaande witruimte wordt genegeerd; anders veroorzaakt een lege sep eenValueError.
- splitlines(keepends: bool = False) list¶
Geef een lijst van de regels in de string terug, waarbij wordt afgebroken bij
\n,\ren\r\n. Regeleinden worden niet opgenomen tenzij keepends waar is.
- startswith(prefix: str | tuple, start: int = 0, end: int = -1) bool¶
Geef
Trueterug 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].
- 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.
- 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 eenValueErrorals value niet aanwezig is.
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+Cte 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
SystemExitmomenteel 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.