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.