Zobrazenie dokumentácie funkcie v Pythone

V tele funkcie je možné uviesť reťazec, ktorý popisuje podstatu jej činnosti. Takýto reťazec sa zvyčajne považuje za dokumentáciu funkcie. Je uzavretý v jednoduchých úvodzovkách a umiestnený v prvom riadku tela funkcie. Na jej prečítanie je potrebné použiť špeciálnu funkciu help, do parametra ktorej sa odovzdáva názov funkcie.

Predpokladajme, že máme funkciu, ktorá sčíta dve čísla. Táto informácia je uvedená v reťazci s príslušnou dokumentáciou:

def getSum(num1, num2):
	'táto funkcia sčíta dve čísla'
	return num1 + num2

Zavolajme help a zistime, čo je zakomentované v getSum:

help(getSum)

Po vykonaní kódu sa v konzole objaví reťazec s názvom funkcie a jej dokumentáciou:

Help on function getSum in module __main__:

getSum(num1, num2)
	táto funkcia sčíta dve čísla

Pomocou funkcie help je možné čítať dokumentáciu aj štandardných funkcií. Zistime informácie o funkcii print:

help(print)

Ak chcete zobraziť iba reťazec s dokumentáciou funkcie, je potrebné odovzdať do help za názvom funkcie servisnú konštrukciu .__doc__:

help(print.__doc__)

Vytvorte funkciu, ktorá bude prijímať parameter ako zoznam názvov mesiacov a zobrazovať ich s veľkým počiatočným písmenom. Popíšte podstatu činnosti funkcie v dokumentácii a zobrazte ju v konzole.

Zobrazte celú dokumentáciu o funkcii sum.

Zobrazte iba reťazec s dokumentáciou o funkcii len.