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.