Funktion dokumentaation näyttäminen Pythonissa

Funktion sisällä voit kirjoittaa merkkijonon, joka kuvaa suoritettavan työn ydintä. Tällaista merkkijonoa pidetään yleisesti funktion dokumentaationa. Se on yksittäisten lainausmerkkien sisällä ja sijoitetaan funktion rungon ensimmäiselle riville. Lukeaksesi sen, sinun on käytettävä erityistä funktiota help, jonka parametriin annetaan funktion nimi.

Oletetaan, että meillä on funktio, joka laskee kahden luvun summan. Tästä on jätetty rivi vastaavilla tiedoilla:

def getSum(num1, num2):
	'tämä funktio laskee kahden luvun summan'
	return num1 + num2

Kutsutaan help ja selvitetään, mitä on kommentoitu funktioon getSum:

help(getSum)

Koodin suorittamisen jälkeen konsoliin ilmestyy rivi funktion nimellä ja sen dokumentaatiolla:

Help on function getSum in module __main__:

getSum(num1, num2)
	tämä funktio laskee kahden luvun summan

Funktiolla help voit lukea dokumentaatiota myös vakiofunktioista. Selvitetään tietoa funktiosta print:

help(print)

Jos haluat tulostaa vain dokumentaatiomerkkijonon funktiosta, sinun on annettava help-funktiolle funktion nimen jälkeen palvelun rakennus .__doc__:

help(print.__doc__)

Luo funktio, joka ottaa vastaan parametrina listan kuukausien nimistä ja tulostaa ne isolla alkukirjaimella. Kuvaa funktion toiminnan ydintä dokumentaatiossa ja tulosta se konsoliin.

Tulosta kaikki dokumentaatio funktiosta sum.

Tulosta vain dokumentaatiomerkkijono funktiosta len.