Standardní knihovna pro Python - 1 (builtins)

27. 2. 2006 | Jakub Matys

Články - Standardní knihovna pro Python - 1 (builtins)  

Vítám vás u nového seriálu, který by vás měl provést standardní knihovnou dodávanou k jazyku Python. Informace uvedené v článcích jsou aktuální pro Python v. 2.4. V dnešním díle začneme probírat vestavěné objekty, tzv. builtins.

Většina programovacích jazyků používá jádro jazyka (všechna klíčová slova) a knihovny, které se starají o obtížnější nebo hardwarově závislé operace. Python není žádnou výjimkou. Vzhledem k tomu, že se jedná o interpretovaný jazyk, mohou být moduly napsány v Pythonu nebo v C. C verze mají určitě výkonnostní výhodu, protože jsou přeloženy přímo do binárního kódu a jsou spojeny rovnou s interpretem (tyto moduly jsou řešeny jako dynamické knihovny - .so).

Aby programátor nemusel stále opisovat importní příkaz, jsou některé hojně používané objekty umístěny ve vestavěném modulu. Vestavěný modul se nazývá __builtins__. Abychom měli práci ještě více usnadněnou, jsou implicitně objekty z tohoto modulu nakopírovány do lokální množiny názvů. Nemusíme tedy u těchto objektů zadávat jmenný prostor. Místo __builtins__.int(x) můžeme zadat prostě int(x). Pojďme se tedy podívat na objekty modulu __builtins__.

Modul __builtinst__

__import__(name[,globals[,locals[,fromlist]]])

Tuto funkci volá příkaz import při načítání nových modulů. Můžete ji samozřejmě použít ve svých funkcích všude tam, kde hodláte importovat nový modul. První argument představuje jméno načítaného modulu, globals a locals jsou slovníky obsahující globální a lokální proměnné. Parametr fromlist představuje seznam objektů vyjímaných z modulu (from xxx import neco). Poslední parametr by nás mohl trochu zmást. Mohli bychom si myslet, že po jeho zadání vrátí funkce pouze objekty toho názvu. Funkce však vrací stále objekt modulu. Porovnává ale klíče slovníku locals s hodnotami v fromlist. Samotné nakopírování do lokální množiny názvů je však na nás. Chceme-li například importovat funkci exit, musíme zadat:

exit = __import__('sys', globals(), locals(), [exit]).exit

Asi tuto funkci nebudete používat tímto způsobem, ale přes jednoduchý příkaz import. Ukazuje nám však (ona i jiné funkce z __builtins__), jak Python vnitřně funguje.

abs(x)

Funkce vrací absolutní hodnotu čísla předaného jako argument. Ten by měl být celým, celým dlouhým (LongType) nebo číslem s pohyblivou řádovou čárkou. Při předání komplexního čísla funkce pracuje standardně (abs(komplex) == math.sqrt(komplex.real ** 2 + komplex.imag ** 2)).

basestring

Tento objekt je mateřskou třídou pro řetězcové typy (str a unicode). Můžete pomocí něho testovat objekty, zda jsou jeho instancemi, tzn. řetězci: isinstance(obj, basestring).

bool([x])

Konvertuje předávanou hodnotu na typ BooleanType. Používá standardní konverzní scénáře. Pokud funkci nepředáme žádný argument vrací False.

callable(object)

Kontroluje, zda je objekt volatelný - vrací True, nebo ne - False (objekty metod a funkcí obsahují metodu __call__()). Nekontroluje, zda volání objektu neskončí s chybou. Třídy jsou také volatelnými typy - vracejí instanci sebe sama.

chr(i)

Funkce vrací ASCII znak, který odpovídá kódu i. Ten musí být v rozsahu 0 - 255, jinak bude vyvolána výjimka ValueError. Funkce je inverzní k funkci ord().

classmethod(function)

Vrací třídní metodu funkce function. Více o třídních metodách se dozvíte v Létajícím cirkusu č. 7 [root.cz]. Místo této funkce je možné použít tzv. dekorátory. Ty se uvádějí před metodou a vypadají např. takto @classmethod. O dekorátorech se více dozvíte v článku Nový chřestýš [root.cz].

cmp(x, y)

Porovnává předávané objekty a vrací celočíselnou hodnotu. Pokud je x < y, je vrácená hodnota záporná. Když se oba argumenty rovnají, vrací nulu a jestliže je x > y, předá kladné číslo.

compile(string, filename, kind[, flags[, dont_inherit]])

Předávaný řetězec je zkompilován do kódového objektu. Takovýto objekt je možné dále spouštět funkcemi exec() nebo eval(). filename představuje soubor, ze kterého je kód čten. Nemáme-li příkazy nikde uloženy můžeme, použít řetězec '<string>'. kind specifikuje, jaký druh kódu bude kompilován. Pokud se jedná o sled příkazů, předáme 'exec'. Jedná-li se o výraz, předáme 'eval'. A nakonec, pokud jde o jeden proveditelný příkaz, předáme 'single'. Kompilujeme-li několikařádkový kód, musí být konec řádku reprezentován '\n'. Jestliže váš systém používá '\r\n' (Windows), musíte toto nahradit, např. metodou replace() (to říká dokumentace, nezkoušel jsem).

complex([real[, imag]])

Funkce vytváří komplexní číslo ze zadaných parametrů. Může přejímat čísla nebo řetězec. Předáte-li řetězec jako první argument, bude interpretován jako komplexní číslo a druhý parametr nesmí být předán! Pokud není druhý argument předán (a první je číslo), je jeho hodnota nastavena na 0 a funkce funguje jako konverzní funkce. Pokud jsou oba parametry vynechány, vrací funkce 0j.

delattr(object, name)

Maže atribut name v objektu object. delattr(x, 'neco') je ekvivalentem del x.neco.

dict([mapping-or-sequence])

Vrací nový slovník vytvoření z argumentu(ů). Jestliže není žádný argument předán, vytvoří prázdný slovník. Předáte-li jako parametr mapovací objekt, vrátí slovník se stejným párováním (klíč -> hodnota). V ostatních případech musí být argument posloupnost, kontejner podporující iterátory nebo objekt iterátoru. Jednotlivé prvky parametru musí být stejných typů a obsahovat 2 objekty. Je-li některý klíč předán vícekrát, je v novém slovníku použita pouze jeho poslední hodnota. Můžete také kombinaci klíč->hodnota předat jako klíčové_slovo = hodnota (např. jedna=1).

dict({'one': 2, 'two': 3})
dict({'one': 2, 'two': 3}.items())
dict({'one': 2, 'two': 3}.iteritems())
dict(zip(('one', 'two'), (2, 3)))
dict([['two', 3], ['one', 2]])
dict(one=2, two=3)
dict([(['one', 'two'][i-2], i) for i in (2, 3)])

Všechny tyto příkazy jsou ekvivalentem k {"one": 2, "two": 3}.

Seriál Standardní knihovna pro Python (dílů: 8)

První díl: Standardní knihovna pro Python - 1 (builtins), poslední díl: Standardní knihovna pro Python - 8 (regulární výrazy 1).
Následující díl: Standardní knihovna pro Python - 2 (builtins 2)