Funktsiooni dokumentatsiooni kuvamine Pythonis

Funktsiooni kehas saab kirjutada stringi, kirjeldamaks tehtava töö olemust. Sellist stringi peetakse tavaliselt funktsiooni dokumentatsiooniks. See paigutatakse ühekordsete jutumärkide sisse ja asub funktsiooni keha esimesel real. Selle lugemiseks tuleb kasutada spetsiaalset funktsiooni help, mille parameetrisse antakse funktsiooni nimi.

Olgu meil funktsioon, mis liidab kaks numbrit. Sellest on jäetud string vastava teabega:

def getSum(num1, num2):
	'see funktsioon liidab kaks numbrit'
	return num1 + num2

Väljutame help ja uurime, mis on kommenteeritud funktsioonis getSum:

help(getSum)

Pärast koodi käivitamist kuvatakse konsoolis funktsiooni nimi ja selle dokumentatsioon:

Help on function getSum in module __main__:

getSum(num1, num2)
	see funktsioon liidab kaks numbrit

Funktsiooni help abil saab lugeda ka standardfunktsioonide dokumentatsiooni. Uurime funktsiooni print kohta käivat teavet:

help(print)

Et väljutada ainult funktsiooni dokumentatsioonistring, tuleb help-ile edastada pärast funktsiooni nimet teeninduskonstruktsioon .__doc__:

help(print.__doc__)

Looge funktsioon, mis võtab parameetrina kuude nimetuste loendi ja kuvab need suure algustähega. Kirjeldage funktsiooni töö olemust dokumentatsioonis ja kuvage see konsoolis.

Kuva kogu dokumentatsioon funktsiooni sum kohta.

Kuva ainult dokumentatsioonistring funktsiooni len kohta.