`builtins` — beépített függvények és kivételek#

Az összes beépített függvény és kivétel itt van leírva. Ezek a builtins modulon keresztül is elérhetők.

Függvények és típusok#

abs(x: Any) → Any#: Visszaadja egy szám abszolút értékét. Az argumentum lehet egész szám, lebegőpontos szám vagy bármely olyan objektum, amely megvalósítja az __abs__() metódust.

all(iterable: Iterable[Any]) → bool#: Visszaadja a True értéket, ha az iterable minden eleme igaz értékű (vagy ha az iterálható üres).

any(iterable: Iterable[Any]) → bool#: Visszaadja a True értéket, ha az iterable bármely eleme igaz értékű. False értéket ad vissza, ha az iterálható üres.

bin(x: int) → str#: Egy egész számot "0b" előtaggal ellátott bináris karakterlánccá alakít. Az argumentumnak Python egész számnak kell lennie, vagy meg kell valósítania az __index__() metódust.

class bool(x: Any = False)#: Logikai értéket ad vissza, azaz a True vagy False egyikét. Az x értéket a szokásos igazságvizsgálati eljárással konvertálja.

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

Egész számok módosítható, 0-255 tartományba eső sorozata. A létrehozás ugyanazokat a szabályokat követi, mint a bytes esetében: egész számból (ekkora méretű, nullákkal feltöltött puffert hozva létre), egész számok iterálhatójából, encoding megadásával egy karakterláncból, vagy bármely buffer protokollt támogató objektumból. Támogatja a szokásos sorozatműveleteket, valamint a helyben történő módosítást.

classmethod fromhex(string: str) → bytearray#: Egy bytearray objektumot hoz létre hexadecimális számjegypárokból álló karakterláncból. A számjegypárok közötti szóközöket átugorja; egy nem hexadecimális karakter ValueError kivételt vált ki.

append(val: int) → None#: Egyetlen értéket (egy 0-255 tartományba eső egész számot) fűz a bytearray végéhez, egy bájttal megnövelve azt.

center(width: int, fillbyte: bytes) → bytes#: Visszaadja a tartalom egy width hosszúságú sorozatba középre igazított másolatát, fillbyte értékkel kitöltve. A CPythontól eltérően a fillbyte kötelező. Ha a width nem nagyobb a jelenlegi hossznál, az adat változatlanul kerül visszaadásra.

count(sub: bytes, start: int = 0, end: int = -1) → int#: Visszaadja a sub nem átfedő előfordulásainak számát a [start:end] szeletben.

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool#: Visszaadja a True értéket, ha a tartalom suffix végződésre végződik. A CPythontól eltérően a suffix nem lehet értékek tuple-je.

extend(iterable: Iterable[int]) → None#: Az iterable összes elemét a bytearray végéhez fűzi. A CPython kiterjesztéseként bármely buffer protokollt támogató objektum használható.

find(sub: bytes, start: int = 0, end: int = -1) → int#: Visszaadja a legalacsonyabb indexet, ahol a sub megtalálható a [start:end] szeletben, vagy -1 értéket, ha nem található.

format(*args: Any, **kwargs: Any) → str#: Karakterlánc-formázási műveletet hajt végre a tartalmat használva formátum-karakterláncként, és visszaadja a formázott eredményt.

hex(sep: str = '') → str#: Visszaad egy két hexadecimális számjegyből álló karakterláncot minden egyes bájtra. Ha az opcionális sep (egy 1 hosszúságú karakterlánc) meg van adva, az egymást követő bájtértékek közé kerül beillesztésre.

index(sub: bytes, start: int = 0, end: int = -1) → int#: Mint a find(), de ValueError kivételt vált ki, ha a sub nem található.

isalpha() → bool#: Visszaadja a True értéket, ha minden bájt alfabetikus ASCII karakter, és legalább egy bájt van, egyébként False értéket.

isdigit() → bool#: Visszaadja a True értéket, ha minden bájt ASCII decimális számjegy, és legalább egy bájt van, egyébként False értéket.

islower() → bool#: Visszaadja a True értéket, ha minden kis- és nagybetűt megkülönböztető bájt kisbetűs, és legalább egy ilyen bájt van, egyébként False értéket.

isspace() → bool#: Visszaadja a True értéket, ha minden bájt ASCII szóköz karakter, és legalább egy bájt van, egyébként False értéket.

isupper() → bool#: Visszaadja a True értéket, ha minden kis- és nagybetűt megkülönböztető bájt nagybetűs, és legalább egy ilyen bájt van, egyébként False értéket.

join(iterable: Iterable[bytes]) → bytes#: Visszaad egy bytes objektumot, amely az iterable elemeinek összefűzése, a bytearray tartalmát használva elválasztóként.

lower() → bytes#: Visszaadja a tartalom olyan másolatát, amelyben minden ASCII nagybetűs karakter kisbetűsre van alakítva.

lstrip(chars: bytes | None = None) → bytes#: Visszaad egy másolatot, amelyből a kezdő bájtok el lettek távolítva. A chars megadja az eltávolítandó bájtok halmazát; ha elhagyják vagy None, az ASCII szóköz karakterek kerülnek eltávolításra.

partition(sep: bytes) → tuple#: A sep első előfordulásánál szétvág, és a (head, sep, tail) hármast adja vissza. Ha a sep nem található, a tartalmat adja vissza két üres objektummal követve.

replace(old: bytes, new: bytes, count: int = -1) → bytes#: Visszaad egy másolatot, amelyben az old minden előfordulása new értékre van cserélve. Ha a count meg van adva, csak az első count előfordulás kerül cserélésre.

rfind(sub: bytes, start: int = 0, end: int = -1) → int#: Visszaadja a legmagasabb indexet, ahol a sub megtalálható a [start:end] szeletben, vagy -1 értéket, ha nem található.

rindex(sub: bytes, start: int = 0, end: int = -1) → int#: Mint a rfind(), de ValueError kivételt vált ki, ha a sub nem található.

rpartition(sep: bytes) → tuple#: A sep utolsó előfordulásánál szétvág, és a (head, sep, tail) hármast adja vissza. Ha a sep nem található, két üres objektumot ad vissza, amelyeket a tartalom követ.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list#: A sep előfordulásainál szétvágja egy darabokból álló listára, legfeljebb maxsplit szétvágást végezve jobbról számolva. Ha a sep None vagy elhagyják, ASCII szóköz karakterek sorozatainál vág szét.

rstrip(chars: bytes | None = None) → bytes#: Visszaad egy másolatot, amelyből a záró bájtok el lettek távolítva. A chars megadja az eltávolítandó bájtok halmazát; ha elhagyják vagy None, az ASCII szóköz karakterek kerülnek eltávolításra.

split(sep: bytes | None = None, maxsplit: int = -1) → list#: A sep előfordulásainál szétvágja egy darabokból álló listára. Ha a sep None vagy elhagyják, ASCII szóköz karakterek sorozatainál vág szét, és a kezdő/záró szóközöket figyelmen kívül hagyja.

splitlines(keepends: bool = False) → list#: Visszaadja a sorok listáját, a \n, \r és \r\n karaktereknél tördelve. A sortörések nem kerülnek be, hacsak a keepends nem igaz.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool#: Visszaadja a True értéket, ha a tartalom prefix előtaggal kezdődik. A CPythontól eltérően a prefix nem lehet tuple, és az end elfogadott, de figyelmen kívül hagyott.

strip(chars: bytes | None = None) → bytes#: Visszaad egy másolatot, amelyből a kezdő és záró bájtok el lettek távolítva. A chars megadja az eltávolítandó bájtok halmazát; ha elhagyják vagy None, az ASCII szóköz karakterek kerülnek eltávolításra.

upper() → bytes#: Visszaadja a tartalom olyan másolatát, amelyben minden ASCII kisbetűs karakter nagybetűsre van alakítva.

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

Egész számok módosíthatatlan, 0-255 tartományba eső sorozata. Létrehozható egész számból (nullákkal feltöltött puffer), egész számok iterálhatójából, encoding megadásával egy karakterláncból, vagy bármely buffer protokollt támogató objektumból. A bytes literálok a b'...' szintaxist használják.

classmethod fromhex(string: str) → bytes#: Egy bytes objektumot hoz létre hexadecimális számjegypárokból álló karakterláncból. A számjegypárok közötti szóközöket átugorja; egy nem hexadecimális karakter ValueError kivételt vált ki.

center(width: int, fillbyte: bytes) → bytes#: Visszaad egy width hosszúságú sorozatba középre igazított másolatot, fillbyte értékkel kitöltve (egy 1 hosszúságú bytes, amely megadja a kitöltő bájtot). A CPythontól eltérően a fillbyte kötelező. Ha a width nem nagyobb a hossznál, az eredeti objektum változatlanul kerül visszaadásra.

count(sub: bytes, start: int = 0, end: int = -1) → int#: Visszaadja a sub nem átfedő előfordulásainak számát a [start:end] szeletben.

decode(encoding: str = 'utf-8') → str#: Visszaad egy a bájtokból dekódolt str objektumot. A MicroPythonban az encoding argumentum elfogadott, de gyakorlatilag figyelmen kívül hagyott (a bájtok UTF-8-ként kerülnek újraértelmezésre).

endswith(suffix: bytes, start: int = 0, end: int = -1) → bool#: Visszaadja a True értéket, ha a bájtok suffix végződésre végződnek. A CPythontól eltérően a suffix nem lehet kipróbálandó értékek tuple-je.

find(sub: bytes, start: int = 0, end: int = -1) → int#: Visszaadja a legalacsonyabb indexet, ahol a sub részsorozat megtalálható a [start:end] szeletben, vagy -1 értéket, ha nem található.

format(*args: Any, **kwargs: Any) → str#: Karakterlánc-formázási műveletet hajt végre a bájtokat használva formátum-karakterláncként, és visszaadja a formázott eredményt.

hex(sep: str = '') → str#: Visszaad egy két hexadecimális számjegyből álló karakterláncot minden egyes bájtra. Ha az opcionális sep (egy 1 hosszúságú karakterlánc) meg van adva, az egymást követő bájtértékek közé kerül beillesztésre.

index(sub: bytes, start: int = 0, end: int = -1) → int#: Mint a find(), de ValueError kivételt vált ki, ha a sub nem található.

isalpha() → bool#: Visszaadja a True értéket, ha minden bájt alfabetikus ASCII karakter, és legalább egy bájt van, egyébként False értéket.

isdigit() → bool#: Visszaadja a True értéket, ha minden bájt ASCII decimális számjegy, és legalább egy bájt van, egyébként False értéket.

islower() → bool#: Visszaadja a True értéket, ha minden kis- és nagybetűt megkülönböztető bájt kisbetűs, és legalább egy ilyen bájt van, egyébként False értéket.

isspace() → bool#: Visszaadja a True értéket, ha minden bájt ASCII szóköz karakter, és legalább egy bájt van, egyébként False értéket.

isupper() → bool#: Visszaadja a True értéket, ha minden kis- és nagybetűt megkülönböztető bájt nagybetűs, és legalább egy ilyen bájt van, egyébként False értéket.

join(iterable: Iterable[bytes]) → bytes#: Visszaad egy bytes objektumot, amely az iterable elemeinek összefűzése, magát a bytes objektumot használva elválasztóként.

lower() → bytes#: Visszaad egy másolatot, amelyben minden ASCII nagybetűs karakter kisbetűsre van alakítva.

lstrip(chars: bytes | None = None) → bytes#: Visszaad egy másolatot, amelyből a kezdő bájtok el lettek távolítva. A chars megadja az eltávolítandó bájtok halmazát; ha elhagyják vagy None, az ASCII szóköz karakterek kerülnek eltávolításra.

partition(sep: bytes) → tuple#: A sep első előfordulásánál szétvág, és a (head, sep, tail) hármast adja vissza. Ha a sep nem található, a bájtokat adja vissza két üres bytes objektummal követve.

replace(old: bytes, new: bytes, count: int = -1) → bytes#: Visszaad egy másolatot, amelyben az old minden előfordulása new értékre van cserélve. Ha a count meg van adva, csak az első count előfordulás kerül cserélésre.

rfind(sub: bytes, start: int = 0, end: int = -1) → int#: Visszaadja a legmagasabb indexet, ahol a sub megtalálható a [start:end] szeletben, vagy -1 értéket, ha nem található.

rindex(sub: bytes, start: int = 0, end: int = -1) → int#: Mint a rfind(), de ValueError kivételt vált ki, ha a sub nem található.

rpartition(sep: bytes) → tuple#: A sep utolsó előfordulásánál szétvág, és a (head, sep, tail) hármast adja vissza. Ha a sep nem található, két üres bytes objektumot ad vissza, amelyeket a bájtok követnek.

rsplit(sep: bytes | None = None, maxsplit: int = -1) → list#: A sep előfordulásainál szétvágja egy darabokból álló listára, legfeljebb maxsplit szétvágást végezve jobbról számolva. Ha a sep None vagy elhagyják, ASCII szóköz karakterek sorozatainál vág szét.

rstrip(chars: bytes | None = None) → bytes#: Visszaad egy másolatot, amelyből a záró bájtok el lettek távolítva. A chars megadja az eltávolítandó bájtok halmazát; ha elhagyják vagy None, az ASCII szóköz karakterek kerülnek eltávolításra.

split(sep: bytes | None = None, maxsplit: int = -1) → list#: A sep előfordulásainál szétvágja egy darabokból álló listára. Ha a sep None vagy elhagyják, ASCII szóköz karakterek sorozatainál vág szét, és a kezdő/záró szóközöket figyelmen kívül hagyja.

splitlines(keepends: bool = False) → list#: Visszaadja a sorok listáját, a \n, \r és \r\n karaktereknél tördelve. A sortörések nem kerülnek be, hacsak a keepends nem igaz.

startswith(prefix: bytes, start: int = 0, end: int = -1) → bool#: Visszaadja a True értéket, ha a bájtok prefix előtaggal kezdődnek. A CPythontól eltérően a prefix nem lehet tuple, és az end elfogadott, de figyelmen kívül hagyott.

strip(chars: bytes | None = None) → bytes#: Visszaad egy másolatot, amelyből a kezdő és záró bájtok el lettek távolítva. A chars megadja az eltávolítandó bájtok halmazát; ha elhagyják vagy None, az ASCII szóköz karakterek kerülnek eltávolításra.

upper() → bytes#: Visszaad egy másolatot, amelyben minden ASCII kisbetűs karakter nagybetűsre van alakítva.

callable(obj: Any) → bool#: Visszaadja a True értéket, ha az obj meghívhatónak tűnik, egyébként False értéket.

chr(i: int) → str#: Visszaad egy egykarakteres karakterláncot, amelynek Unicode kódpontja az i egész szám.

classmethod(func: Callable[..., Any]) → classmethod#: Egy metódust osztálymetódussá alakít. Jellemzően dekorátorként használatos.

compile(source: str | bytes, filename: str, mode: str) → Any#: A source forrást olyan kódobjektummá fordítja, amelyet az exec() vagy eval() végrehajthat. A mode a "exec", "eval" vagy "single" egyike.

class complex(real: float | str = 0, imag: float = 0)#: Komplex számot hoz létre egy valós és egy képzetes részből, vagy egy karakterláncból.

delattr(obj, name: str) → None#: A name argumentumnak karakterláncnak kell lennie, és ez a függvény törli a megnevezett attribútumot az obj által megadott objektumból.

class dict(*args, **kwargs)#

Új szótárt hoz létre. Megfelel a CPython dict típusának.

classmethod fromkeys(iterable: Iterable[Any], value: Any = None) → dict#: Új szótárt hoz létre, amelynek kulcsai az iterable elemeiből származnak, mindegyik a value értékre leképezve (alapértelmezetten None). A típuson hívandó, pl. dict.fromkeys(...).

clear() → None#: Eltávolítja az összes elemet a szótárból, üresen hagyva azt. TypeError kivételt vált ki, ha a szótár rögzített (csak olvasható).

copy() → dict#: Visszaadja a szótár sekély másolatát. A visszaadott objektum típusa megegyezik az eredetiével (dict vagy OrderedDict), de nem rögzített.

get(key: Any, default: Any = None) → Any#: Visszaadja a key kulcshoz tartozó értéket, ha az a szótárban van, egyébként a default értéket adja vissza (amely maga is alapértelmezetten None, így ez soha nem vált ki KeyError kivételt). A szótár nem módosul.

items() → Any#: Visszaad egy dinamikus nézetobjektumot a (key, value) párok felett, amely tükrözi a szótár későbbi módosításait, és támogatja az iterálást, a len() függvényt, az in operátort és a halmaz-összehasonlító operátorokat.

keys() → Any#: Visszaad egy dinamikus nézetobjektumot a kulcsok felett, amely tükrözi a szótár későbbi módosításait, és támogatja az iterálást, a len() függvényt, az in operátort és a halmaz-összehasonlító operátorokat.

pop(key: Any, default: Any = None) → Any#: Eltávolítja a key kulcsot a szótárból, és visszaadja annak értékét. Ha a key nincs jelen, a default értéket adja vissza, ha az meg lett adva; egyébként KeyError kivételt vált ki. TypeError kivételt vált ki, ha a szótár rögzített.

popitem() → tuple#: Eltávolít és visszaad egy tetszőleges (key, value) párt 2 elemű tuple-ként. Egy egyszerű dict esetén a kiválasztott pár meghatározatlan; egy OrderedDict esetén az utoljára beillesztett pár kerül eltávolításra (LIFO). KeyError kivételt vált ki, ha a szótár üres, vagy TypeError kivételt, ha rögzített.

setdefault(key: Any, default: Any = None) → Any#: Ha a key a szótárban van, visszaadja annak értékét. Egyébként beilleszti a key kulcsot default értékkel (alapértelmezetten None), és visszaadja azt az értéket. TypeError kivételt vált ki, ha a szótár rögzített.

update(*args: Any, **kwargs: Any) → None#: Helyben frissíti a szótárt. Legfeljebb egy pozicionális argumentum fogadható el: vagy egy másik szótár, vagy kételemű (key, value) párok iterálhatója (mindegyiknek pontosan két elemet kell adnia, különben ValueError kivétel keletkezik). Ezután a kulcsszó-argumentumok karakterlánc-kulcsú bejegyzésekként kerülnek hozzáadásra. A meglévő kulcsok felülíródnak. TypeError kivételt vált ki, ha a szótár rögzített.

values() → Any#: Visszaad egy dinamikus nézetobjektumot az értékek felett, amely tükrözi a szótár későbbi módosításait, és támogatja az iterálást és a len() függvényt.

__getitem__(key: Any) → Any#: Visszaadja a self[key] értéket. Megvalósítja a d[key] indexelő operátort; KeyError kivételt vált ki, ha a key nincs jelen.

__setitem__(key: Any, value: Any) → None#: Beállítja a self[key] értéket value értékre. Megvalósítja a d[key] = value műveletet.

__delitem__(key: Any) → None#: Törli a self[key] elemet. Megvalósítja a del d[key] műveletet; KeyError kivételt vált ki, ha a key nincs jelen.

dir(obj: Any = None) → list#: Argumentumok nélkül visszaadja a jelenlegi lokális hatókörben lévő nevek listáját. Egy argumentummal visszaadja az adott objektum érvényes attribútumainak listáját.

divmod(a: Any, b: Any) → tuple#: Visszaadja az (a // b, a % b) párt tuple-ként, két (nem komplex) szám esetén.

enumerate(iterable: Iterable[Any], start: int = 0) → Iterator[tuple]#: Visszaad egy enumerate objektumot, amely (index, value) párokat ad ki az iterable elemeiből, az indexet start értéktől kezdve.

eval(expression: str | bytes, globals: dict | None = None, locals: dict | None = None) → Any#: Kiértékel egy karakterláncként (vagy lefordított kódobjektumként) megadott Python kifejezést, és visszaadja az eredményt.

exec(object: str | bytes, globals: dict | None = None, locals: dict | None = None) → None#: Dinamikusan végrehajt karakterláncként vagy lefordított kódobjektumként megadott Python kódot.

filter(function: Callable[[Any], Any] | None, iterable: Iterable[Any]) → Iterator[Any]#: Iterátort hoz létre az iterable azon elemeiből, amelyekre a function igaz értéket ad vissza. Ha a function értéke None, az identitásfüggvényt feltételezi.

class float(x: str | bytes | int | float = 0.0)#: Visszaad egy számból vagy x karakterláncból létrehozott lebegőpontos számot.

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

Visszaad egy új frozenset objektumot, opcionálisan az iterable elemeivel. A frozenset a set módosíthatatlan, hashelhető változata.

copy() → frozenset#: Visszaadja a frozenset sekély másolatát.

difference(*others: Iterable[Any]) → frozenset#: Visszaad egy új frozenset objektumot a frozenset azon elemeivel, amelyek egyik others halmazban sincsenek benne. Minden argumentum bármilyen iterálható lehet.

intersection(other: Iterable[Any]) → frozenset#: Visszaad egy új frozenset objektumot a frozenset és az other közös elemeivel. A MicroPythonban csak egyetlen other argumentum fogadható el (a CPython többet is elfogad).

isdisjoint(other: Iterable[Any]) → bool#: Visszaadja a True értéket, ha a frozenset és az other között nincs közös elem.

issubset(other: Iterable[Any]) → bool#: Visszaadja a True értéket, ha a frozenset minden eleme benne van az other halmazban.

issuperset(other: Iterable[Any]) → bool#: Visszaadja a True értéket, ha az other minden eleme benne van a frozenset halmazban.

symmetric_difference(other: Iterable[Any]) → frozenset#: Visszaad egy új frozenset objektumot azokkal az elemekkel, amelyek vagy a frozenset, vagy az other halmazban vannak, de nem mindkettőben. A MicroPythonban csak egyetlen other argumentum fogadható el.

union(other: Iterable[Any]) → frozenset#: Visszaad egy új frozenset objektumot a frozenset és az other elemeivel. A MicroPythonban csak egyetlen other argumentum fogadható el (a CPython többet is elfogad).

getattr(obj: Any, name: str, default: Any = None) → Any#: Visszaadja az obj megnevezett attribútumának értékét. Ha az attribútum nem létezik, a default érték kerül visszaadásra, ha meg van adva, egyébként AttributeError kivétel keletkezik.

globals() → dict#: Visszaad egy szótárt, amely a jelenlegi modul globális szimbólumtábláját reprezentálja.

hasattr(obj: Any, name: str) → bool#: Visszaadja a True értéket, ha az obj rendelkezik a megadott name nevű attribútummal, egyébként False értéket.

hash(obj: Any) → int#: Visszaadja az obj hash értékét (ha van neki). A hash értékek olyan egész számok, amelyeket a szótárkulcsok gyors összehasonlítására használnak szótári keresés során.

hex(x: int) → str#: Egy egész számot "0x" előtaggal ellátott kisbetűs hexadecimális karakterlánccá alakít.

id(obj: Any) → int#: Visszaadja egy objektum identitását. Ez egy egész szám, amely garantáltan egyedi és állandó az objektum élettartama alatt.

input(prompt: str = '') → str#: Beolvas egy sort a standard bemenetről, és karakterláncként adja vissza (záró sortörés nélkül). Ha a prompt meg van adva, az először a standard kimenetre íródik záró sortörés nélkül.

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

classmethod from_bytes(bytes: bytes, byteorder: str) → int#: A MicroPythonban a byteorder paraméternek pozicionálisnak kell lennie (ez kompatibilis a CPythonnal).

to_bytes(size: int, byteorder: str) → bytes#: A MicroPythonban a byteorder paraméternek pozicionálisnak kell lennie (ez kompatibilis a CPythonnal).

Megjegyzés
A CPython opcionális signed kulcsszó-argumentuma nem támogatott. A MicroPython jelenleg a negatív egész számokat előjelesen, a pozitívakat előjel nélkül konvertálja. (Részletek.)

isinstance(obj: Any, classinfo: type | tuple) → bool#: Visszaadja a True értéket, ha az obj a classinfo vagy annak bármely alosztályának példánya. A classinfo lehet egy osztály vagy osztályok tuple-je.

issubclass(cls: type, classinfo: type | tuple) → bool#: Visszaadja a True értéket, ha a cls a classinfo (közvetlen, közvetett vagy virtuális) alosztálya.

iter(obj: Any, sentinel: Any = None) → Iterator[Any]#: Visszaad egy iterátorobjektumot. Egy argumentummal az obj objektumnak támogatnia kell az iterálási protokollt. Két argumentummal az obj objektumnak meghívhatónak kell lennie, és az iterálás akkor áll le, amikor az a sentinel értéket adja vissza.

len(obj: Any) → int#: Visszaadja egy konténer elemeinek számát.

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

Új listát hoz létre, opcionálisan az iterable elemeivel feltöltve.

append(object: Any) → None#: Az object elemet a lista végéhez fűzi.

clear() → None#: Eltávolítja az összes elemet a listából, üresen hagyva azt.

copy() → list#: Visszaadja a lista sekély másolatát.

count(value: Any) → int#: Visszaadja a listában a value értékkel egyenlő elemek számát.

extend(iterable: Iterable[Any]) → None#: Az iterable összes elemét a lista végéhez fűzi. Ha az iterable maga is lista, az elemei közvetlenül másolódnak; egyébként végigiterál rajta.

index(value: Any, start: int = 0, stop: int = -1) → int#: Visszaadja az első, a value értékkel egyenlő elem indexét, a [start:stop] szeletben keresve. ValueError kivételt vált ki, ha a value nincs jelen.

insert(index: int, object: Any) → None#: Beilleszti az object elemet az index pozíció elé. A negatív index a lista végéhez viszonyítva értelmezendő, és az index az érvényes tartományra van korlátozva (így a végeken túli értékek az elejére vagy a végére illesztenek be).

pop(index: int = -1) → Any#: Eltávolítja és visszaadja az index pozíción lévő elemet (alapértelmezetten az utolsó elemet). IndexError kivételt vált ki, ha a lista üres vagy az index tartományon kívül esik.

remove(value: Any) → None#: Eltávolítja az első, a value értékkel egyenlő elemet. ValueError kivételt vált ki, ha a value nincs jelen.

reverse() → None#: Helyben megfordítja a lista elemeinek sorrendjét.

sort(*, key: Callable[[Any], Any] | None = None, reverse: bool = False) → None#: Helyben rendezi a lista elemeit. A key és a reverse csak kulcsszóként adható meg. A key, ha meg van adva, egy függvény, amely minden elemre alkalmazva előállítja az összehasonlítási értéket; a reverse csökkenő sorrendbe rendez.

Megjegyzés
A CPythontól eltérően a MicroPython listarendezése nem stabil.

locals() → dict#: Visszaad egy szótárt, amely a jelenlegi lokális szimbólumtáblát reprezentálja.

map(function: Callable[..., Any], *iterables: Iterable[Any]) → Iterator[Any]#: Visszaad egy iterátort, amely a function függvényt alkalmazza az iterables minden elemére, kiadva az eredményeket.

max(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any#: Egyetlen iterálható argumentummal visszaadja annak legnagyobb elemét. Két vagy több argumentummal a legnagyobb argumentumot adja vissza.

class memoryview(obj: Any)#: Létrehoz egy memoryview-t, amely az obj objektumra hivatkozik, amelynek támogatnia kell a buffer protokollt (pl. bytes, bytearray, array.array). Lehetővé teszi az alapul szolgáló memória másolásmentes elérését és szeletelését; egy memoryview szeletelése másolat helyett egy másik memoryview-t ad vissza.

min(*args: Any, key: Callable[[Any], Any] | None = None, default: Any = None) → Any#: Egyetlen iterálható argumentummal visszaadja annak legkisebb elemét. Két vagy több argumentummal a legkisebb argumentumot adja vissza.

next(iterator: Iterator[Any], default: Any = None) → Any#: Lekéri a következő elemet az iterator objektumból. Ha a default meg van adva, és az iterátor kimerült, a default érték kerül visszaadásra a StopIteration kivétel kiváltása helyett.

class object#: Visszaad egy új, jellemzők nélküli objektumot. Az object az összes osztály ősosztálya.

oct(x: int) → str#: Egy egész számot "0o" előtaggal ellátott oktális karakterlánccá alakít.

open(file: str, mode: str = 'r', **kwargs) → Any#: Megnyitja a file fájlt, és visszaad egy hozzá tartozó fájlobjektumot. A mode alapértelmezett értéke "r" a szöveges olvasáshoz.

ord(c: str) → int#: Visszaadja egy egykarakteres c karakterlánc Unicode kódpontját egész számként.

pow(base: Any, exp: Any, mod: Any | None = None) → Any#: Visszaadja a base értéket az exp hatványra emelve. Ha a mod meg van adva, a base ** exp % mod értéket adja vissza (az explicit alaknál hatékonyabban kiszámítva).

print(*objects: Any, sep: str = ' ', end: str = '\n', file: Any = None) → None#: Kiírja az objects objektumokat a file szöveges adatfolyamba, sep értékkel elválasztva és end értékkel követve.

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#: Visszaad egy property attribútumot. Jellemzően dekorátorként használatos egy osztály felügyelt attribútumainak meghatározására.

range(*args: int) → range#: Visszaad egész számok módosíthatatlan sorozatát. Hívható range(stop), range(start, stop) vagy range(start, stop, step) formában.

repr(obj: Any) → str#: Visszaad egy karakterláncot, amely az obj objektum nyomtatható reprezentációját tartalmazza.

reversed(seq: Any) → Iterator[Any]#: Visszaad egy fordított iterátort az adott sorozat értékei felett.

round(number: Any, ndigits: int | None = None) → Any#: Visszaadja a number értéket ndigits tizedesjegyre kerekítve. Ha az ndigits el van hagyva, a legközelebbi egész számot adja vissza.

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

Visszaad egy új set objektumot, opcionálisan az iterable elemeivel.

add(elem: Any) → None#: Hozzáadja az elem elemet a halmazhoz.

clear() → None#: Eltávolítja az összes elemet a halmazból.

copy() → set#: Visszaadja a halmaz sekély másolatát.

difference(*others: Iterable[Any]) → set#: Visszaad egy új halmazt a halmaz azon elemeivel, amelyek egyik others halmazban sincsenek benne. Minden argumentum bármilyen iterálható lehet.

difference_update(*others: Iterable[Any]) → None#: Eltávolítja a halmazból az összes olyan elemet, amely bármely others halmazban megtalálható (helyben).

discard(elem: Any) → None#: Eltávolítja az elem elemet a halmazból, ha jelen van. A remove() metódussal ellentétben ez nem vált ki hibát, ha az elem nincs jelen.

intersection(other: Iterable[Any]) → set#: Visszaad egy új halmazt a halmaz és az other közös elemeivel. A MicroPythonban csak egyetlen other argumentum fogadható el (a CPython többet is elfogad).

intersection_update(other: Iterable[Any]) → None#: Frissíti a halmazt, csak az other halmazban is megtalálható elemeket megtartva (helyben). A MicroPythonban csak egyetlen other argumentum fogadható el.

isdisjoint(other: Iterable[Any]) → bool#: Visszaadja a True értéket, ha a halmaz és az other között nincs közös elem.

issubset(other: Iterable[Any]) → bool#: Visszaadja a True értéket, ha a halmaz minden eleme benne van az other halmazban.

issuperset(other: Iterable[Any]) → bool#: Visszaadja a True értéket, ha az other minden eleme benne van a halmazban.

pop() → Any#: Eltávolít és visszaad egy tetszőleges elemet a halmazból. KeyError kivételt vált ki, ha a halmaz üres.

remove(elem: Any) → None#: Eltávolítja az elem elemet a halmazból. KeyError kivételt vált ki, ha az elem nincs benne a halmazban.

symmetric_difference(other: Iterable[Any]) → set#: Visszaad egy új halmazt azokkal az elemekkel, amelyek vagy a halmazban, vagy az other halmazban vannak, de nem mindkettőben. A MicroPythonban csak egyetlen other argumentum fogadható el.

symmetric_difference_update(other: Iterable[Any]) → None#: Frissíti a halmazt, csak azokat az elemeket megtartva, amelyek vagy a halmazban, vagy az other halmazban vannak, de nem mindkettőben (helyben). A MicroPythonban csak egyetlen other argumentum fogadható el.

union(other: Iterable[Any]) → set#: Visszaad egy új halmazt a halmaz és az other elemeivel. A MicroPythonban csak egyetlen other argumentum fogadható el (a CPython többet is elfogad).

update(*others: Iterable[Any]) → None#: Frissíti a halmazt, hozzáadva az összes others halmaz elemeit (helyben).

setattr(obj: Any, name: str, value: Any) → None#: Beállítja az obj megnevezett attribútumát value értékre. A getattr() ellenpárja.

class slice#: A slice beépített elem az a típus, amellyel a slice objektumok rendelkeznek.

sorted(iterable: Iterable[Any], key: Callable[[Any], Any] | None = None, reverse: bool = False) → list#: Visszaad egy új rendezett listát az iterable elemeiből.

staticmethod(func: Callable[..., Any]) → staticmethod#: Egy metódust statikus metódussá alakít. Jellemzően dekorátorként használatos.

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

Visszaadja az object objektum karakterlánc-változatát. Ha az object egy bytes-szerű objektum, az encoding és errors argumentumok szabályozzák a dekódolást.

center(width: int) → str#: Visszaadja a karakterlánc width hosszúságú mezőbe középre igazított másolatát, szóközökkel kitöltve. A MicroPythonban csak szóköz használatos kitöltő karakterként (nincs kitöltő-karakter argumentum), és ha a width nem nagyobb a hossznál, az eredeti karakterlánc változatlanul kerül visszaadásra.

count(sub: str, start: int = 0, end: int = -1) → int#: Visszaadja a sub nem átfedő előfordulásainak számát a [start:end] szeletben. Egy üres sub minden karakterek közötti rést megszámol.

encode(encoding: str = 'utf-8', errors: str = 'strict') → bytes#: Visszaad egy a karakterláncot kódoló bytes objektumot. A MicroPython gyakorlatilag figyelmen kívül hagyja az argumentumokat, és UTF-8-at használ; az errors elfogadott, de nem hat rá. Megfelel a bytes(s, "utf-8") hívásnak.

endswith(suffix: str | tuple, start: int = 0, end: int = -1) → bool#: Visszaadja a True értéket, ha a karakterlánc a megadott suffix végződésre végződik, amely lehet egyetlen karakterlánc vagy kipróbálandó karakterláncok tuple-je. Az opcionális start és end a összehasonlítást a [start:end] szeletre korlátozzák.

find(sub: str, start: int = 0, end: int = -1) → int#: Visszaadja a karakterláncban a legalacsonyabb indexet, ahol a sub részkarakterlánc megtalálható a [start:end] szeletben, vagy -1 értéket, ha nem található.

format(*args: Any, **kwargs: Any) → str#: Karakterlánc-formázási műveletet hajt végre, a kapcsos zárójelekkel {} határolt helyettesítési mezőket az args és kwargs értékeivel helyettesítve. Támogatja a szabványos formátum-specifikációs mini-nyelvet.

index(sub: str, start: int = 0, end: int = -1) → int#: Mint a find(), de ValueError kivételt vált ki, ha a sub részkarakterlánc nem található a [start:end] szeletben.

isalpha() → bool#: Visszaadja a True értéket, ha a karakterlánc minden karaktere alfabetikus, és a karakterlánc nem üres, egyébként False értéket.

isdigit() → bool#: Visszaadja a True értéket, ha a karakterlánc minden karaktere számjegy, és a karakterlánc nem üres, egyébként False értéket.

islower() → bool#: Visszaadja a True értéket, ha a karakterlánc legalább egy alfabetikus karaktert tartalmaz, és minden ilyen karakter kisbetűs, egyébként False értéket.

isspace() → bool#: Visszaadja a True értéket, ha a karakterlánc minden karaktere szóköz, és a karakterlánc nem üres, egyébként False értéket.

isupper() → bool#: Visszaadja a True értéket, ha a karakterlánc legalább egy alfabetikus karaktert tartalmaz, és minden ilyen karakter nagybetűs, egyébként False értéket.

join(iterable: Iterable[str]) → str#: Összefűzi az iterable karakterláncait, ezt a karakterláncot illesztve be elválasztóként az elemek közé. Az elemeknek karakterláncoknak kell lenniük, egyébként TypeError kivétel keletkezik.

lower() → str#: Visszaadja a karakterlánc olyan másolatát, amelyben minden karakter kisbetűsre van alakítva.

lstrip(chars: str | None = None) → str#: Visszaadja a karakterlánc olyan másolatát, amelyből a kezdő karakterek el lettek távolítva. Ha a chars el van hagyva vagy None, a szóközök kerülnek eltávolításra; egyébként a chars az eltávolítandó karakterek halmazaként van kezelve.

partition(sep: str) → tuple#: Szétvágja a karakterláncot a sep első előfordulásánál, és visszaad egy 3 elemű (head, sep, tail) tuple-t. Ha a sep nem található, a (self, "", "") értéket adja vissza. Egy üres sep ValueError kivételt vált ki.

replace(old: str, new: str, count: int = -1) → str#: Visszaadja a karakterlánc olyan másolatát, amelyben az old részkarakterlánc minden előfordulása new értékre van cserélve. Ha a count meg van adva és nem negatív, csak az első count előfordulás kerül cserélésre.

rfind(sub: str, start: int = 0, end: int = -1) → int#: Visszaadja a karakterláncban a legmagasabb indexet, ahol a sub részkarakterlánc megtalálható a [start:end] szeletben, vagy -1 értéket, ha nem található.

rindex(sub: str, start: int = 0, end: int = -1) → int#: Mint a rfind(), de ValueError kivételt vált ki, ha a sub részkarakterlánc nem található a [start:end] szeletben.

rpartition(sep: str) → tuple#: Szétvágja a karakterláncot a sep utolsó előfordulásánál, és visszaad egy 3 elemű (head, sep, tail) tuple-t. Ha a sep nem található, a ("", "", self) értéket adja vissza. Egy üres sep ValueError kivételt vált ki.

rsplit(sep: str | None = None, maxsplit: int = -1) → list#: Jobbról szétvágja a karakterláncot részkarakterláncok listájára a sep elválasztó használatával, legfeljebb maxsplit szétvágást végezve. maxsplit nélkül (vagy negatív értékkel) azonosan viselkedik a split() metódussal; a MicroPythonban a rsplit(None, n) nem negatív n értékkel NotImplementedError kivételt vált ki.

rstrip(chars: str | None = None) → str#: Visszaadja a karakterlánc olyan másolatát, amelyből a záró karakterek el lettek távolítva. Ha a chars el van hagyva vagy None, a szóközök kerülnek eltávolításra; egyébként a chars az eltávolítandó karakterek halmazaként van kezelve.

split(sep: str | None = None, maxsplit: int = -1) → list#: Szétvágja a karakterláncot részkarakterláncok listájára a sep elválasztó használatával, legfeljebb maxsplit szétvágást végezve. Ha a sep el van hagyva vagy None, szóköz karakterek sorozatainál vág szét a kezdő szóközöket figyelmen kívül hagyva; egyébként egy üres sep ValueError kivételt vált ki.

splitlines(keepends: bool = False) → list#: Visszaadja a karakterlánc sorainak listáját, a \n, \r és \r\n karaktereknél tördelve. A sortörések nem kerülnek be, hacsak a keepends nem igaz.

startswith(prefix: str | tuple, start: int = 0, end: int = -1) → bool#: Visszaadja a True értéket, ha a karakterlánc a megadott prefix előtaggal kezdődik, amely lehet egyetlen karakterlánc vagy kipróbálandó karakterláncok tuple-je. Az opcionális start és end az összehasonlítást a [start:end] szeletre korlátozzák.

strip(chars: str | None = None) → str#: Visszaadja a karakterlánc olyan másolatát, amelyből a kezdő és záró karakterek el lettek távolítva. Ha a chars el van hagyva vagy None, a szóközök kerülnek eltávolításra; egyébként a chars az eltávolítandó karakterek halmazaként van kezelve.

upper() → str#: Visszaadja a karakterlánc olyan másolatát, amelyben minden karakter nagybetűsre van alakítva.

sum(iterable: Iterable[Any], start: Any = 0) → Any#: Balról jobbra összeadja a start értéket és az iterable elemeit, és visszaadja az összeget.

super(type: type | None = None, obj_or_type: Any | None = None) → Any#: Visszaad egy proxy objektumot, amely a metódushívásokat a type egy szülő- vagy testvérosztályához delegálja. Hasznos az olyan örökölt metódusok eléréséhez, amelyeket egy osztályban felülírtak.

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

Új tuple-t hoz létre, opcionálisan az iterable elemeivel feltöltve. A tuple-ök módosíthatatlan sorozatok.

count(value: Any) → int#: Visszaadja a tuple-ben a value értékkel egyenlő elemek számát.

index(value: Any, start: int = 0, stop: int = -1) → int#: Visszaadja az első, a value értékkel egyenlő elem indexét, a [start:stop] szeletben keresve. ValueError kivételt vált ki, ha a value nincs jelen.

type(obj: Any) → type#: Egy argumentummal visszaadja az obj típusát. A visszaadott érték egy típusobjektum.

zip(*iterables: Iterable[Any]) → Iterator[tuple]#: Visszaad egy tuple-ökből álló iterátort, ahol az i-edik tuple az egyes argumentum-iterálhatók i-edik elemét tartalmazza. Az iterálás akkor áll le, amikor a legrövidebb bemeneti iterálható kimerül.

Kivételek#

exception AssertionError#: Akkor keletkezik, amikor egy assert utasítás meghiúsul.

exception AttributeError#: Akkor keletkezik, amikor egy attribútumra való hivatkozás vagy értékadás meghiúsul.

exception Exception#: Az összes nem rendszerkilépő kivétel közös ősosztálya.

exception ImportError#: Akkor keletkezik, amikor egy import utasítás nem találja a modul definícióját.

exception IndexError#: Akkor keletkezik, amikor egy sorozat indexe tartományon kívül esik.

exception KeyboardInterrupt#

Akkor keletkezik, amikor a felhasználó megszakítja a program végrehajtását, általában a Ctrl+C lenyomásával a REPL-en.

Lásd még a Szoftveres lefagyás (indítási hiba) kontextusában.

exception KeyError#: Akkor keletkezik, amikor egy leképezés (szótár) kulcsa nem található a meglévő kulcsok halmazában.

exception MemoryError#: Akkor keletkezik, amikor egy művelet kifut a memóriából.

exception NameError#: Akkor keletkezik, amikor egy lokális vagy globális név nem található.

exception NotImplementedError#: Akkor keletkezik, amikor egy absztrakt metódust vagy megvalósítatlan jellemzőt hívnak meg.

exception OSError#: Akkor keletkezik, amikor egy rendszerfüggvény rendszerrel kapcsolatos hibát ad vissza.

exception RuntimeError#: Akkor keletkezik, amikor olyan hibát észlel, amely egyik másik kategóriába sem esik.

exception StopIteration#: A next() és egy iterátor __next__() metódusa váltja ki annak jelzésére, hogy nincsenek további elemek.

exception SyntaxError#: Akkor keletkezik, amikor az értelmező szintaktikai hibát észlel.

exception SystemExit#

A sys.exit() váltja ki az értelmező leállításának kérésére. A legtöbb kivételtől eltérően ez nem hoz létre visszakövetést, ha nem kezelik le.

Az OpenMV Cam eszközön egy lekezeletlen SystemExit jelenleg a MicroPython Szoftveres visszaállítás műveletét okozza.

exception TypeError#: Akkor keletkezik, amikor egy műveletet vagy függvényt nem megfelelő típusú objektumra alkalmaznak.

exception ValueError#: Akkor keletkezik, amikor egy beépített művelet vagy függvény megfelelő típusú, de nem megfelelő értékű argumentumot kap.

exception ZeroDivisionError#: Akkor keletkezik, amikor egy osztás vagy modulo művelet második argumentuma nulla.

builtins — beépített függvények és kivételek#

Függvények és típusok#

Kivételek#

`builtins` — beépített függvények és kivételek#