Natija:
$ python func_doc.py
5
katta
Ikki sondan kattasini chop etadi.
Ikkala qiymat ham butun son bo'lishi kerak.
Bu qanday ishlaydi:
Birinchi
mantiqiy qatordagi
satr funksiya
uchun
docstring
hisoblanadi.
Docstiring
modul
va klasslar bilan ham
qo'llaniladi.
Funksiya docstiringini ko'p qatorli satr ko'rinishida yozish qabul qilingan. Bu
satrning birinchi qatori bosh xarf bilan boshlanadi va nuqta bilan tugaydi.
Ikkinchi qator bo'sh qoldiriladi va funksiya haqidagi to'liq ma'lumot uchunchi
qatordan boshlab yoziladi.
Shunday uslubda docstring yozish tavsiya qilinadi.
printMax
funksiyasining docstringiga shu
funksiyaning
__doc__
atributi
orqali
murojat qilish mumkin (Ikkita belgilash simvoliga e'tibor bering). Shuni
e'tiborga olingki, python "hamma" narsani ob'yekt ko'rinishida tasavvur qiladi.
Agar siz Pythonda
help()
funksiyasini ishlatgan bo'lsangiz, demak, siz
docstringni ko'rgansiz. Bu funksiya tegishli funksiyaning
doc
atributini
hisoblaydi va ifodali holda ekranga chop etadi. Buni yuqoridagi funksiya misolida
ko'rishingiz mumkin.
help(printMax) kodini dastur kodiga qo'shing.
Biz funksiyalarning ko'p qirralarini ko'rib chiqdik, lekin bu hammasi emas. Ko'rib
chiqqanlarimiz pythonda funksiyalar bilan ishlashda duch kelishingiz mumkin
bo'lgan ko'p hollarni qamrab olgan