Python функциясынын документтер чыгаруусу

Функциянын денесинде аткарылуучу иштин мүнөзүн сүрөттөгөн сап жазылышы мүмкүн. Мындай сап функциянын документтер сабы деп эсептелет. Ал бир өтүк тырмакчага алынып, функциянын денесинин биринчи сабында жайгаштырылат. Аны окуш үчүн, атайын help функциясын колдонуу керек, анын параметрине функциянын аты берилет.

Бизде эки санды кошкон функция бар деп коёлу. Бул жөнүндө тиешелүү маалымат сабы калтырылган:

def getSum(num1, num2):
	'this function sums two numbers'
	return num1 + num2

Келгиле, help чакырып, getSum ичинде эмне комментарийленгенин билип алалы:

help(getSum)

Код аткарылгандан кийин консольдо функциянын аты жана анын документтер сабы менен сап пайда болот:

Help on function getSum in module __main__:

getSum(num1, num2)
	this function sums two numbers

help функциясынын жардамы менен стандарттуу функциялардын документтерин да окуса болот. Келгиле, print функциясы жөнүндө маалыматты билип алалы:

help(print)

Функциядан документтер сабын гана чыгаруу үчүн, help функциясына функциянын атынан кийин .__doc__ кызматтык конструкциясын берүү керек:

help(print.__doc__)

Параметри катары айлардын аталышынын тизмесин кабыл алган жана аларды баш тамга менен чыгара турган функция түзүңүз. Функциянын иш мүнөзүн документтер сабында сүрөттөп, аны консолго чыгарыңыз.

sum функциясы жөнүндө бардык документтерди чыгарыңыз.

len функциясы жөнүндө документтер сабын гана чыгарыңыз.