builtins — vestavěné funkce a výjimky

Zde jsou popsány všechny vestavěné funkce a výjimky. Jsou rovněž dostupné prostřednictvím modulu builtins.

Funkce a typy

abs(x: Any) → Any

Vrátí absolutní hodnotu čísla. Argumentem může být celé číslo, číslo s plovoucí desetinnou čárkou nebo libovolný objekt implementující __abs__().

all(iterable: Iterable[Any]) → bool

Vrátí True, pokud jsou všechny prvky iterable pravdivé (nebo pokud je iterovatelný objekt prázdný).

any(iterable: Iterable[Any]) → bool

Vrátí True, pokud je libovolný prvek iterable pravdivý. Vrátí False, pokud je iterovatelný objekt prázdný.

bin(x: int) → str

Převede celé číslo na binární řetězec s předponou "0b". Argumentem musí být celé číslo Pythonu nebo objekt implementující __index__().

class bool(x: Any = False)

Vrátí logickou hodnotu, tj. jednu z hodnot True nebo False. x se převede pomocí standardního postupu testování pravdivosti.

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

Měnitelná posloupnost celých čísel v rozsahu 0-255. Konstrukce se řídí stejnými pravidly jako u bytes: z celého čísla (vytvoří buffer dané velikosti vyplněný nulami), z iterovatelného objektu celých čísel, z řetězce s encoding nebo z libovolného objektu podporujícího buffer protokol. Podporuje standardní operace nad posloupnostmi a navíc úpravy na místě.

classmethod fromhex(string: str) → bytearray

Sestaví bytearray z řetězce dvojic hexadecimálních číslic. Bílé znaky mezi dvojicemi číslic se přeskakují; znak, který není hexadecimální, vyvolá ValueError.

append(val: int) → None

Přidá jednu hodnotu (celé číslo v rozsahu 0-255) na konec bytearray a zvětší jej o jeden bajt.

center(width: int, fillbyte: bytes) → bytes

Vrátí kopii obsahu vycentrovanou v posloupnosti délky width, doplněnou znakem fillbyte. Na rozdíl od CPythonu je fillbyte povinný. Data se vrátí beze změny, pokud width není větší než aktuální délka.

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

Vrátí počet nepřekrývajících se výskytů sub v řezu [start:end].

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

Vrátí True, pokud obsah končí na suffix. Na rozdíl od CPythonu nemůže být suffix n-ticí hodnot.

extend(iterable: Iterable[int]) → None

Přidá všechny položky z iterable na konec bytearray. Jako rozšíření oproti CPythonu lze použít libovolný objekt podporující buffer protokol.

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

Vrátí nejnižší index, na kterém se sub nachází v řezu [start:end], nebo -1, pokud nebyl nalezen.

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

Provede operaci formátování řetězce, přičemž obsah použije jako formátovací řetězec, a vrátí naformátovaný výsledek.

hex(sep: str = '') → str

Vrátí řetězec dvou hexadecimálních číslic pro každý bajt. Pokud je zadán volitelný sep (řetězec délky 1), vloží se mezi po sobě jdoucí hodnoty bajtů.

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

Stejné jako find(), ale vyvolá ValueError, pokud sub není nalezen.

isalpha() → bool

Vrátí True, pokud jsou všechny bajty abecední ASCII znaky a je přítomen alespoň jeden bajt, jinak False.

isdigit() → bool

Vrátí True, pokud jsou všechny bajty ASCII desítkovými číslicemi a je přítomen alespoň jeden bajt, jinak False.

islower() → bool

Vrátí True, pokud jsou všechny bajty rozlišující velikost písmen malými písmeny a je přítomen alespoň jeden takový bajt, jinak False.

isspace() → bool

Vrátí True, pokud jsou všechny bajty ASCII bílými znaky a je přítomen alespoň jeden bajt, jinak False.

isupper() → bool

Vrátí True, pokud jsou všechny bajty rozlišující velikost písmen velkými písmeny a je přítomen alespoň jeden takový bajt, jinak False.

join(iterable: Iterable[bytes]) → bytes

Vrátí objekt bytes, který je zřetězením položek v iterable s použitím obsahu bytearray jako oddělovače.

lower() → bytes

Vrátí kopii obsahu, ve které jsou všechna velká ASCII písmena převedena na malá.

lstrip(chars: bytes | None = None) → bytes

Vrátí kopii s odstraněnými úvodními bajty. chars určuje množinu bajtů k odstranění; pokud je vynechán nebo None, odstraní se ASCII bílé znaky.

partition(sep: bytes) → tuple

Rozdělí podle prvního výskytu sep a vrátí (head, sep, tail). Pokud sep není nalezen, vrátí obsah následovaný dvěma prázdnými objekty.

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

Vrátí kopii, ve které jsou všechny výskyty old nahrazeny new. Pokud je zadán count, nahradí se pouze prvních count výskytů.

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

Vrátí nejvyšší index, na kterém se sub nachází v řezu [start:end], nebo -1, pokud nebyl nalezen.

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

Stejné jako rfind(), ale vyvolá ValueError, pokud sub není nalezen.

rpartition(sep: bytes) → tuple

Rozdělí podle posledního výskytu sep a vrátí (head, sep, tail). Pokud sep není nalezen, vrátí dva prázdné objekty následované obsahem.

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

Rozdělí podle výskytů sep na seznam částí, přičemž provede nejvýše maxsplit rozdělení počítáno zprava. Pokud je sep None nebo vynechán, rozdělí podle souvislých úseků ASCII bílých znaků.

rstrip(chars: bytes | None = None) → bytes

Vrátí kopii s odstraněnými koncovými bajty. chars určuje množinu bajtů k odstranění; pokud je vynechán nebo None, odstraní se ASCII bílé znaky.

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

Rozdělí podle výskytů sep na seznam částí. Pokud je sep None nebo vynechán, rozdělí podle souvislých úseků ASCII bílých znaků a úvodní/koncové bílé znaky se ignorují.

splitlines(keepends: bool = False) → list

Vrátí seznam řádků, přičemž rozděluje na \n, \r a \r\n. Konce řádků jsou vyloučeny, pokud keepends není pravdivé.

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

Vrátí True, pokud obsah začíná na prefix. Na rozdíl od CPythonu nemůže být prefix n-ticí a end je přijímán, ale ignorován.

strip(chars: bytes | None = None) → bytes

Vrátí kopii s odstraněnými úvodními a koncovými bajty. chars určuje množinu bajtů k odstranění; pokud je vynechán nebo None, odstraní se ASCII bílé znaky.

upper() → bytes

Vrátí kopii obsahu, ve které jsou všechna malá ASCII písmena převedena na velká.

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

Neměnitelná posloupnost celých čísel v rozsahu 0-255. Vytvoří se z celého čísla (buffer vyplněný nulami), z iterovatelného objektu celých čísel, z řetězce s encoding nebo z libovolného objektu podporujícího buffer protokol. Literály bytes používají syntaxi b'...'.

classmethod fromhex(string: str) → bytes

Sestaví objekt bytes z řetězce dvojic hexadecimálních číslic. Bílé znaky mezi dvojicemi číslic se přeskakují; znak, který není hexadecimální, vyvolá ValueError.

center(width: int, fillbyte: bytes) → bytes

Vrátí kopii vycentrovanou v posloupnosti délky width, doplněnou znakem fillbyte (objekt bytes délky 1 udávající výplňový bajt). Na rozdíl od CPythonu je fillbyte povinný. Původní objekt se vrátí beze změny, pokud width není větší než jeho délka.

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

Vrátí počet nepřekrývajících se výskytů sub v řezu [start:end].

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

Vrátí str dekódovaný z bajtů. V MicroPythonu je argument encoding přijímán, ale fakticky ignorován (bajty jsou reinterpretovány jako UTF-8).

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

Vrátí True, pokud bajty končí na suffix. Na rozdíl od CPythonu nemůže být suffix n-ticí hodnot k vyzkoušení.

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

Vrátí nejnižší index, na kterém se podposloupnost sub nachází v řezu [start:end], nebo -1, pokud nebyla nalezena.

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

Provede operaci formátování řetězce, přičemž bajty použije jako formátovací řetězec, a vrátí naformátovaný výsledek.

hex(sep: str = '') → str

Vrátí řetězec dvou hexadecimálních číslic pro každý bajt. Pokud je zadán volitelný sep (řetězec délky 1), vloží se mezi po sobě jdoucí hodnoty bajtů.

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

Stejné jako find(), ale vyvolá ValueError, pokud sub není nalezen.

isalpha() → bool

Vrátí True, pokud jsou všechny bajty abecední ASCII znaky a je přítomen alespoň jeden bajt, jinak False.

isdigit() → bool

Vrátí True, pokud jsou všechny bajty ASCII desítkovými číslicemi a je přítomen alespoň jeden bajt, jinak False.

islower() → bool

Vrátí True, pokud jsou všechny bajty rozlišující velikost písmen malými písmeny a je přítomen alespoň jeden takový bajt, jinak False.

isspace() → bool

Vrátí True, pokud jsou všechny bajty ASCII bílými znaky a je přítomen alespoň jeden bajt, jinak False.

isupper() → bool

Vrátí True, pokud jsou všechny bajty rozlišující velikost písmen velkými písmeny a je přítomen alespoň jeden takový bajt, jinak False.

join(iterable: Iterable[bytes]) → bytes

Vrátí objekt bytes, který je zřetězením položek v iterable s použitím samotného objektu bytes jako oddělovače.

lower() → bytes

Vrátí kopii, ve které jsou všechna velká ASCII písmena převedena na malá.

lstrip(chars: bytes | None = None) → bytes

Vrátí kopii s odstraněnými úvodními bajty. chars určuje množinu bajtů k odstranění; pokud je vynechán nebo None, odstraní se ASCII bílé znaky.

partition(sep: bytes) → tuple

Rozdělí podle prvního výskytu sep a vrátí (head, sep, tail). Pokud sep není nalezen, vrátí bajty následované dvěma prázdnými objekty bytes.

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

Vrátí kopii, ve které jsou všechny výskyty old nahrazeny new. Pokud je zadán count, nahradí se pouze prvních count výskytů.

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

Vrátí nejvyšší index, na kterém se sub nachází v řezu [start:end], nebo -1, pokud nebyl nalezen.

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

Stejné jako rfind(), ale vyvolá ValueError, pokud sub není nalezen.

rpartition(sep: bytes) → tuple

Rozdělí podle posledního výskytu sep a vrátí (head, sep, tail). Pokud sep není nalezen, vrátí dva prázdné objekty bytes následované bajty.

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

Rozdělí podle výskytů sep na seznam částí, přičemž provede nejvýše maxsplit rozdělení počítáno zprava. Pokud je sep None nebo vynechán, rozdělí podle souvislých úseků ASCII bílých znaků.

rstrip(chars: bytes | None = None) → bytes

Vrátí kopii s odstraněnými koncovými bajty. chars určuje množinu bajtů k odstranění; pokud je vynechán nebo None, odstraní se ASCII bílé znaky.

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

Rozdělí podle výskytů sep na seznam částí. Pokud je sep None nebo vynechán, rozdělí podle souvislých úseků ASCII bílých znaků a úvodní/koncové bílé znaky se ignorují.

splitlines(keepends: bool = False) → list

Vrátí seznam řádků, přičemž rozděluje na \n, \r a \r\n. Konce řádků jsou vyloučeny, pokud keepends není pravdivé.

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

Vrátí True, pokud bajty začínají na prefix. Na rozdíl od CPythonu nemůže být prefix n-ticí a end je přijímán, ale ignorován.

strip(chars: bytes | None = None) → bytes

Vrátí kopii s odstraněnými úvodními a koncovými bajty. chars určuje množinu bajtů k odstranění; pokud je vynechán nebo None, odstraní se ASCII bílé znaky.

upper() → bytes

Vrátí kopii, ve které jsou všechna malá ASCII písmena převedena na velká.

callable(obj: Any) → bool

Vrátí True, pokud se obj jeví jako volatelný, jinak False.

chr(i: int) → str

Vrátí řetězec o jednom znaku, jehož Unicode kódovým bodem je celé číslo i.

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

Převede metodu na metodu třídy. Obvykle se používá jako dekorátor.

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

Zkompiluje source do objektu kódu, který lze spustit pomocí exec() nebo eval(). mode je jedno z "exec", "eval" nebo "single".

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

Vytvoří komplexní číslo z reálné a imaginární části nebo z řetězce.

delattr(obj, name: str) → None

Argument name by měl být řetězec a tato funkce odstraní pojmenovaný atribut z objektu daného obj.

class dict(*args, **kwargs)

Vytvoří nový slovník. Ekvivalent dict z CPythonu.

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

Vytvoří nový slovník s klíči převzatými z iterable, z nichž každý je namapován na value (výchozí None). Volá se na typu, např. dict.fromkeys(...).

clear() → None

Odstraní všechny položky ze slovníku a ponechá jej prázdný. Vyvolá TypeError, pokud je slovník pevný (jen pro čtení).

copy() → dict

Vrátí mělkou kopii slovníku. Vrácený objekt má stejný typ jako původní (dict nebo OrderedDict), ale není pevný.

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

Vrátí hodnotu pro key, pokud je ve slovníku, jinak vrátí default (jehož výchozí hodnota je sama None, takže to nikdy nevyvolá KeyError). Slovník se nemění.

items() → Any

Vrátí dynamický objekt náhledu nad dvojicemi (key, value), který odráží následné změny slovníku a podporuje iteraci, len(), operátor in a operátory porovnání množin.

keys() → Any

Vrátí dynamický objekt náhledu nad klíči, který odráží následné změny slovníku a podporuje iteraci, len(), operátor in a operátory porovnání množin.

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

Odstraní key ze slovníku a vrátí jeho hodnotu. Pokud key není přítomen, vrátí default, pokud byl zadán; jinak vyvolá KeyError. Vyvolá TypeError, pokud je slovník pevný.

popitem() → tuple

Odstraní a vrátí libovolnou dvojici (key, value) jako 2-tici. U běžného dict je vybraná dvojice nespecifikovaná; u OrderedDict se odstraní naposledy vložená dvojice (LIFO). Vyvolá KeyError, pokud je slovník prázdný, nebo TypeError, pokud je pevný.

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

Pokud je key ve slovníku, vrátí jeho hodnotu. Jinak vloží key s hodnotou default (výchozí None) a vrátí tuto hodnotu. Vyvolá TypeError, pokud je slovník pevný.

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

Aktualizuje slovník na místě. Přijímá se nejvýše jeden poziční argument: buď jiný slovník, nebo iterovatelný objekt dvouprvkových dvojic (key, value) (každá musí poskytnout přesně dvě položky, jinak je vyvolán ValueError). Klíčové argumenty se poté přidají jako položky s řetězcovými klíči. Existující klíče jsou přepsány. Vyvolá TypeError, pokud je slovník pevný.

values() → Any

Vrátí dynamický objekt náhledu nad hodnotami, který odráží následné změny slovníku a podporuje iteraci a len().

__getitem__(key: Any) → Any

Vrátí self[key]. Implementuje indexovací operátor d[key]; vyvolá KeyError, pokud key není přítomen.

__setitem__(key: Any, value: Any) → None

Nastaví self[key] na value. Implementuje d[key] = value.

__delitem__(key: Any) → None

Odstraní self[key]. Implementuje del d[key]; vyvolá KeyError, pokud key není přítomen.

dir(obj: Any = None) → list

Bez argumentů vrátí seznam názvů v aktuálním lokálním rozsahu. S argumentem vrátí seznam platných atributů daného objektu.

divmod(a: Any, b: Any) → tuple

Vrátí dvojici (a // b, a % b) jako n-tici, pro dvě (nekomplexní) čísla.

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

Vrátí objekt enumerate poskytující dvojice (index, value) z iterable, přičemž index začíná hodnotou start.

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

Vyhodnotí výraz Pythonu zadaný jako řetězec (nebo zkompilovaný objekt kódu) a vrátí výsledek.

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

Dynamicky spustí kód Pythonu poskytnutý jako řetězec nebo zkompilovaný objekt kódu.

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

Sestaví iterátor z těch prvků iterable, pro které function vrací pravdu. Pokud je function None, předpokládá se funkce identity.

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

Vrátí číslo s plovoucí desetinnou čárkou sestavené z čísla nebo řetězce x.

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

Vrátí nový objekt frozenset, volitelně s prvky převzatými z iterable. frozenset je neměnitelná, hašovatelná varianta set.

copy() → frozenset

Vrátí mělkou kopii frozenset.

difference(*others: Iterable[Any]) → frozenset

Vrátí nový frozenset s prvky z frozenset, které nejsou v žádném z others. Každý argument může být libovolný iterovatelný objekt.

intersection(other: Iterable[Any]) → frozenset

Vrátí nový frozenset s prvky společnými frozenset a other. V MicroPythonu je přijímán pouze jediný argument other (CPython přijímá více).

isdisjoint(other: Iterable[Any]) → bool

Vrátí True, pokud frozenset nemá žádné společné prvky s other.

issubset(other: Iterable[Any]) → bool

Vrátí True, pokud je každý prvek frozenset v other.

issuperset(other: Iterable[Any]) → bool

Vrátí True, pokud je každý prvek other ve frozenset.

symmetric_difference(other: Iterable[Any]) → frozenset

Vrátí nový frozenset s prvky buď ve frozenset, nebo v other, ale ne v obou. V MicroPythonu je přijímán pouze jediný argument other.

union(other: Iterable[Any]) → frozenset

Vrátí nový frozenset s prvky z frozenset a other. V MicroPythonu je přijímán pouze jediný argument other (CPython přijímá více).

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

Vrátí hodnotu pojmenovaného atributu obj. Pokud atribut neexistuje, vrátí se default, pokud byl zadán, jinak je vyvolán AttributeError.

globals() → dict

Vrátí slovník reprezentující tabulku globálních symbolů aktuálního modulu.

hasattr(obj: Any, name: str) → bool

Vrátí True, pokud má obj atribut s daným názvem name, jinak False.

hash(obj: Any) → int

Vrátí hašovou hodnotu obj (pokud nějakou má). Hašové hodnoty jsou celá čísla používaná k rychlému porovnávání klíčů slovníku během vyhledávání ve slovníku.

hex(x: int) → str

Převede celé číslo na malými písmeny psaný hexadecimální řetězec s předponou "0x".

id(obj: Any) → int

Vrátí identitu objektu. Jedná se o celé číslo, u kterého je zaručeno, že je jedinečné a konstantní pro tento objekt po dobu jeho životnosti.

input(prompt: str = '') → str

Přečte řádek ze standardního vstupu a vrátí jej jako řetězec (bez koncového znaku nového řádku). Pokud je zadán prompt, nejprve se zapíše na standardní výstup bez koncového znaku nového řádku.

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

classmethod from_bytes(bytes: bytes, byteorder: str) → int

V MicroPythonu musí být parametr byteorder poziční (to je kompatibilní s CPythonem).

to_bytes(size: int, byteorder: str) → bytes

V MicroPythonu musí být parametr byteorder poziční (to je kompatibilní s CPythonem).

Poznámka

Volitelný klíčový argument signed z CPythonu není podporován. MicroPython aktuálně převádí záporná celá čísla jako znaménková a kladná jako neznaménková. (Podrobnosti.)

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

Vrátí True, pokud je obj instancí classinfo nebo některé z jeho podtříd. classinfo může být třída nebo n-tice tříd.

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

Vrátí True, pokud je cls podtřídou (přímou, nepřímou nebo virtuální) classinfo.

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

Vrátí objekt iterátoru. S jedním argumentem musí obj podporovat iterační protokol. Se dvěma argumenty musí být obj volatelný a iterace se zastaví, když vrátí sentinel.

len(obj: Any) → int

Vrátí počet položek v kontejneru.

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

Sestaví nový seznam, volitelně naplněný položkami z iterable.

append(object: Any) → None

Přidá object na konec seznamu.

clear() → None

Odstraní všechny položky ze seznamu a ponechá jej prázdný.

copy() → list

Vrátí mělkou kopii seznamu.

count(value: Any) → int

Vrátí počet prvků v seznamu, které jsou rovny value.

extend(iterable: Iterable[Any]) → None

Přidá všechny položky z iterable na konec seznamu. Pokud je iterable sám seznamem, jeho položky se zkopírují přímo; jinak se přes něj iteruje.

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

Vrátí index prvního prvku rovného value, přičemž prohledává řez [start:stop]. Vyvolá ValueError, pokud value není přítomna.

insert(index: int, object: Any) → None

Vloží object před pozici index. Záporný index se interpretuje vzhledem ke konci seznamu a index je omezen na platný rozsah (takže hodnoty za kterýmkoli koncem vloží na začátek nebo konec).

pop(index: int = -1) → Any

Odstraní a vrátí položku na pozici index (ve výchozím nastavení poslední položku). Vyvolá IndexError, pokud je seznam prázdný nebo je index mimo rozsah.

remove(value: Any) → None

Odstraní první prvek rovný value. Vyvolá ValueError, pokud value není přítomna.

reverse() → None

Obrátí pořadí položek seznamu na místě.

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

Seřadí položky seznamu na místě. key a reverse jsou pouze klíčové. key, pokud je zadán, je funkce aplikovaná na každý prvek pro vytvoření porovnávací hodnoty; reverse řadí v sestupném pořadí.

Poznámka

Na rozdíl od CPythonu není řazení seznamu v MicroPythonu stabilní.

locals() → dict

Vrátí slovník reprezentující aktuální tabulku lokálních symbolů.

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

Vrátí iterátor, který aplikuje function na každou položku z iterables a poskytuje výsledky.

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

S jediným iterovatelným argumentem vrátí jeho největší položku. Se dvěma nebo více argumenty vrátí největší argument.

class memoryview(obj: Any)

Vytvoří memoryview, který odkazuje na obj, jenž musí podporovat buffer protokol (např. bytes, bytearray, array.array). Umožňuje přístup k podkladové paměti a její řezání bez kopírování; řezání memoryview vrací další memoryview namísto kopie.

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

S jediným iterovatelným argumentem vrátí jeho nejmenší položku. Se dvěma nebo více argumenty vrátí nejmenší argument.

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

Získá další položku z iterator. Pokud je zadán default a iterátor je vyčerpán, vrátí se default namísto vyvolání StopIteration.

class object

Vrátí nový objekt bez vlastností. object je základní třídou pro všechny třídy.

oct(x: int) → str

Převede celé číslo na osmičkový řetězec s předponou "0o".

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

Otevře file a vrátí odpovídající objekt souboru. mode má výchozí hodnotu "r" pro textové čtení.

ord(c: str) → int

Vrátí Unicode kódový bod jednoznakového řetězce c jako celé číslo.

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

Vrátí base umocněné na exp. Pokud je zadán mod, vrátí base ** exp % mod (vypočteno efektivněji než explicitní forma).

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

Vytiskne objects do textového proudu file, oddělené pomocí sep a následované 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

Vrátí atribut typu property. Obvykle se používá jako dekorátor k definování spravovaných atributů na třídě.

range(*args: int) → range

Vrátí neměnitelnou posloupnost celých čísel. Volá se jako range(stop), range(start, stop) nebo range(start, stop, step).

repr(obj: Any) → str

Vrátí řetězec obsahující tisknutelnou reprezentaci obj.

reversed(seq: Any) → Iterator[Any]

Vrátí obrácený iterátor přes hodnoty dané posloupnosti.

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

Vrátí number zaokrouhlené na ndigits desetinných míst. Pokud je ndigits vynechán, vrátí nejbližší celé číslo.

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

Vrátí nový objekt set, volitelně s prvky převzatými z iterable.

add(elem: Any) → None

Přidá prvek elem do množiny.

clear() → None

Odstraní všechny prvky z množiny.

copy() → set

Vrátí mělkou kopii množiny.

difference(*others: Iterable[Any]) → set

Vrátí novou množinu s prvky z množiny, které nejsou v žádném z others. Každý argument může být libovolný iterovatelný objekt.

difference_update(*others: Iterable[Any]) → None

Odstraní z množiny všechny prvky nalezené v kterémkoli z others (na místě).

discard(elem: Any) → None

Odstraní prvek elem z množiny, pokud je přítomen. Na rozdíl od remove() to nevyvolá chybu, pokud elem chybí.

intersection(other: Iterable[Any]) → set

Vrátí novou množinu s prvky společnými množině a other. V MicroPythonu je přijímán pouze jediný argument other (CPython přijímá více).

intersection_update(other: Iterable[Any]) → None

Aktualizuje množinu, ponechá pouze prvky nalezené také v other (na místě). V MicroPythonu je přijímán pouze jediný argument other.

isdisjoint(other: Iterable[Any]) → bool

Vrátí True, pokud množina nemá žádné společné prvky s other.

issubset(other: Iterable[Any]) → bool

Vrátí True, pokud je každý prvek množiny v other.

issuperset(other: Iterable[Any]) → bool

Vrátí True, pokud je každý prvek other v množině.

pop() → Any

Odstraní a vrátí libovolný prvek z množiny. Vyvolá KeyError, pokud je množina prázdná.

remove(elem: Any) → None

Odstraní prvek elem z množiny. Vyvolá KeyError, pokud elem není v množině obsažen.

symmetric_difference(other: Iterable[Any]) → set

Vrátí novou množinu s prvky buď v množině, nebo v other, ale ne v obou. V MicroPythonu je přijímán pouze jediný argument other.

symmetric_difference_update(other: Iterable[Any]) → None

Aktualizuje množinu, ponechá pouze prvky nalezené buď v množině, nebo v other, ale ne v obou (na místě). V MicroPythonu je přijímán pouze jediný argument other.

union(other: Iterable[Any]) → set

Vrátí novou množinu s prvky z množiny a other. V MicroPythonu je přijímán pouze jediný argument other (CPython přijímá více).

update(*others: Iterable[Any]) → None

Aktualizuje množinu, přidá prvky ze všech others (na místě).

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

Nastaví pojmenovaný atribut na obj na hodnotu value. Protějšek getattr().

class slice

Vestavěný slice je typ, který mají objekty slice.

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

Vrátí nový seřazený seznam z položek v iterable.

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

Převede metodu na statickou metodu. Obvykle se používá jako dekorátor.

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

Vrátí řetězcovou verzi object. Pokud je object objektem typu bytes, argumenty encoding a errors řídí dekódování.

center(width: int) → str

Vrátí kopii řetězce vycentrovanou v poli délky width, doplněnou mezerami. V MicroPythonu se jako výplňový znak používá pouze mezera (neexistuje argument pro výplňový znak) a původní řetězec se vrátí beze změny, pokud width není větší než jeho délka.

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

Vrátí počet nepřekrývajících se výskytů sub v řezu [start:end]. Prázdný sub počítá každou mezeru mezi znaky.

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

Vrátí objekt bytes kódující řetězec. MicroPython argumenty fakticky ignoruje a používá UTF-8; errors je přijímán, ale nemá žádný účinek. Ekvivalent bytes(s, "utf-8").

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

Vrátí True, pokud řetězec končí daným suffix, kterým může být jeden řetězec nebo n-tice řetězců k vyzkoušení. Volitelné start a end omezují porovnání na řez [start:end].

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

Vrátí nejnižší index v řetězci, na kterém se podřetězec sub nachází v řezu [start:end], nebo -1, pokud nebyl nalezen.

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

Provede operaci formátování řetězce, přičemž nahrazovací pole vymezená složenými závorkami {} nahradí hodnotami z args a kwargs. Podporuje standardní mini-jazyk specifikace formátu.

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

Stejné jako find(), ale vyvolá ValueError, pokud podřetězec sub není nalezen v řezu [start:end].

isalpha() → bool

Vrátí True, pokud jsou všechny znaky v řetězci abecední a řetězec je neprázdný, jinak False.

isdigit() → bool

Vrátí True, pokud jsou všechny znaky v řetězci číslicemi a řetězec je neprázdný, jinak False.

islower() → bool

Vrátí True, pokud řetězec obsahuje alespoň jeden abecední znak a všechny takové znaky jsou malými písmeny, jinak False.

isspace() → bool

Vrátí True, pokud jsou všechny znaky v řetězci bílými znaky a řetězec je neprázdný, jinak False.

isupper() → bool

Vrátí True, pokud řetězec obsahuje alespoň jeden abecední znak a všechny takové znaky jsou velkými písmeny, jinak False.

join(iterable: Iterable[str]) → str

Zřetězí řetězce v iterable a mezi prvky vloží tento řetězec jako oddělovač. Položky musí být řetězce, jinak je vyvolán TypeError.

lower() → str

Vrátí kopii řetězce se všemi znaky převedenými na malá písmena.

lstrip(chars: str | None = None) → str

Vrátí kopii řetězce s odstraněnými úvodními znaky. Pokud je chars vynechán nebo None, oříznou se bílé znaky; jinak je chars považován za množinu znaků k odstranění.

partition(sep: str) → tuple

Rozdělí řetězec podle prvního výskytu sep a vrátí 3-tici (head, sep, tail). Pokud sep není nalezen, vrátí (self, "", ""). Prázdný sep vyvolá ValueError.

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

Vrátí kopii řetězce se všemi výskyty podřetězce old nahrazenými new. Pokud je zadán count a je nezáporný, nahradí se pouze prvních count výskytů.

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

Vrátí nejvyšší index v řetězci, na kterém se podřetězec sub nachází v řezu [start:end], nebo -1, pokud nebyl nalezen.

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

Stejné jako rfind(), ale vyvolá ValueError, pokud podřetězec sub není nalezen v řezu [start:end].

rpartition(sep: str) → tuple

Rozdělí řetězec podle posledního výskytu sep a vrátí 3-tici (head, sep, tail). Pokud sep není nalezen, vrátí ("", "", self). Prázdný sep vyvolá ValueError.

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

Rozdělí řetězec zprava na seznam podřetězců s použitím sep jako oddělovače, přičemž provede nejvýše maxsplit rozdělení. Bez maxsplit (nebo se záporným) se chová identicky jako split(); v MicroPythonu rsplit(None, n) s nezáporným n vyvolá NotImplementedError.

rstrip(chars: str | None = None) → str

Vrátí kopii řetězce s odstraněnými koncovými znaky. Pokud je chars vynechán nebo None, oříznou se bílé znaky; jinak je chars považován za množinu znaků k odstranění.

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

Rozdělí řetězec na seznam podřetězců s použitím sep jako oddělovače, přičemž provede nejvýše maxsplit rozdělení. Pokud je sep vynechán nebo None, rozdělí podle souvislých úseků bílých znaků s ignorováním úvodních bílých znaků; jinak prázdný sep vyvolá ValueError.

splitlines(keepends: bool = False) → list

Vrátí seznam řádků v řetězci, přičemž rozděluje na \n, \r a \r\n. Konce řádků nejsou zahrnuty, pokud keepends není pravdivé.

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

Vrátí True, pokud řetězec začíná daným prefix, kterým může být jeden řetězec nebo n-tice řetězců k vyzkoušení. Volitelné start a end omezují porovnání na řez [start:end].

strip(chars: str | None = None) → str

Vrátí kopii řetězce s odstraněnými úvodními a koncovými znaky. Pokud je chars vynechán nebo None, oříznou se bílé znaky; jinak je chars považován za množinu znaků k odstranění.

upper() → str

Vrátí kopii řetězce se všemi znaky převedenými na velká písmena.

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

Sečte start a položky z iterable zleva doprava a vrátí součet.

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

Vrátí proxy objekt, který deleguje volání metod na nadřazenou nebo sourozeneckou třídu typu type. Užitečné pro přístup ke zděděným metodám, které byly ve třídě přepsány.

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

Sestaví novou n-tici, volitelně naplněnou položkami z iterable. N-tice jsou neměnitelné posloupnosti.

count(value: Any) → int

Vrátí počet prvků v n-tici, které jsou rovny value.

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

Vrátí index prvního prvku rovného value, přičemž prohledává řez [start:stop]. Vyvolá ValueError, pokud value není přítomna.

type(obj: Any) → type

S jedním argumentem vrátí typ obj. Vrácenou hodnotou je objekt typu.

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

Vrátí iterátor n-tic, kde i-tá n-tice obsahuje i-tý prvek z každého z argumentových iterovatelných objektů. Iterace se zastaví, když je vyčerpán nejkratší vstupní iterovatelný objekt.

Výjimky

exception AssertionError

Vyvolá se, když selže příkaz assert.

exception AttributeError

Vyvolá se, když selže odkaz na atribut nebo přiřazení atributu.

exception Exception

Společná základní třída pro všechny výjimky, které neukončují systém.

exception ImportError

Vyvolá se, když příkaz import nenajde definici modulu.

exception IndexError

Vyvolá se, když je dolní index posloupnosti mimo rozsah.

exception KeyboardInterrupt

Vyvolá se, když uživatel přeruší provádění programu, obvykle stisknutím Ctrl+C v REPL.

Viz také v kontextu Měkké zablokování (soft bricking, selhání spuštění).

exception KeyError

Vyvolá se, když klíč mapování (slovníku) není nalezen v množině existujících klíčů.

exception MemoryError

Vyvolá se, když operaci dojde paměť.

exception NameError

Vyvolá se, když lokální nebo globální název není nalezen.

exception NotImplementedError

Vyvolá se, když je vyvolána abstraktní metoda nebo neimplementovaná funkce.

exception OSError

Vyvolá se, když systémová funkce vrátí chybu související se systémem.

exception RuntimeError

Vyvolá se, když je zjištěna chyba, která nespadá do žádné z ostatních kategorií.

exception StopIteration

Vyvolá se funkcí next() a metodou __next__() iterátoru jako signál, že nejsou žádné další položky.

exception SyntaxError

Vyvolá se, když parser narazí na syntaktickou chybu.

exception SystemExit

Vyvolá se funkcí sys.exit() jako požadavek na ukončení interpretu. Na rozdíl od většiny výjimek neprodukuje při nezachycení traceback.

Na OpenMV Cam aktuálně nezachycený SystemExit způsobí Měkký reset MicroPythonu.

exception TypeError

Vyvolá se, když je operace nebo funkce aplikována na objekt nevhodného typu.

exception ValueError

Vyvolá se, když vestavěná operace nebo funkce obdrží argument správného typu, ale nevhodné hodnoty.

exception ZeroDivisionError

Vyvolá se, když je druhým argumentem operace dělení nebo modulo nula.