Python za radoznale: Oblikovanje Python koda (indentacija i komentiranje)
Hrvoje Katić
Indentacija linije koda je broj razmaka prije početka aktualnog koda, i
to je Pythonov način grupiranja blokova naredbi u programskom kodu, tj.
način odvajanja blokova koda od ostatka programa. Indentacija u Pythonu,
dakle, označava kada blokovi naredbi u kodu počinju i završavaju. Blok
naredbi je skup linija koda sa istom količinom indentacije (istim brojem
razmaka ispred linije). Blokovi naredbi mogu u sebi sadržavati i druge
blokove naredbi sa većom količinom indentacije.
Za razliku od nekih drugih programskih jezika, indentacija je u Pythonu
obavezno pravilo i ukoliko se ne upotrebljava na mjestima gdje je
potrebno, program će javiti grešku i neće se htjeti izvršiti, ma koliko
god bio ispravan.
U drugim programskim jezicima, indentacija uopće nije potrebna. Svaki
blok naredbi nalazi se unutar vitičastih zagrada ({}) (otvorena za
početak bloka i zatvorena za kraj bloka), dok neki jezici kao recimo
Visual Basic za završavanje blokova naredbi koriste ključne riječi
EndFunction, EndIf, EndWhile, EndTry, i po tome se zna da je tu kraj
bloka naredbi. Delphi koristi ključne riječi begin za početak bloka i
end za kraj bloka naredbi.
U Pythonu, međutim, to funkcionira drugačije. Budući da Python nema
ključnih riječi ili simbole koji označavaju kraj određenog bloka
naredbi, u Pythonu se koristi tzv. whitespace indentacija. Sve linije
koda koje želimo staviti unutar istog bloka naredbi moramo uvuči za isti
broj razmaka. Povećanje broja razmaka dolazi nakon znaka dvotočke (:)
koja označava početak bloka naredbi, dok smanjivanje broja razmaka
označava kraj trenutnog bloka naredbi.
Za indentaciju bloka naredbi koristimo razmak ili tabulator (tipka iznad
caps locka). Savjet: nemojte miješati simbole za indentaciju, niti
upotrebljavati u kodu malo jedan simbol pa malo drugi. Odlučite se za
jedan koji vam bolje odgovara i taj koristite u cijelom kodu vašeg programa.
Komentiranje Python koda
Što je naš programski kod veći i kompleksniji, tim kod postaje teži za
čitanje, pogotovo onima koji ga pregledavaju po prvi put. Također,
dolazi do situacija gdje je neke stvari u programskom kodu potrebno
ukratko opisati, kako bi drugi programeri koji čitaju naš kod mogli
shvatiti što smo time htjeli reći. Komentari u Python programu počinju
znakom ljestve (#) koji se piše tako da se drži tipka Shift i broj 3, a
završavaju prelaskom u novi red. Ako ste već radili u nekim drugim
programskim jezicima, onda znate da C i C++ koriste znakove // za unos
komentara, Visual Basic koristi znak apostrofa ('), ponegdje se koristi
znak točkazarez (;) i sl. Evo kao primjer ćemo prepisati program iz
primjera 1, ali ćemo mu dodati komentare.
#Ovo je prvi komentar
#Primjer unosa teksta
print "Unesite neki tekst." # ispisuje zahtjev za unos teksta
uneseno = raw_input() # definira varijablu unos i funkciju raw_input kao
njezinu vrijednost, te ceka od korisnika da nesto upise
print "Napisali ste ovaj tekst:"
print unos # ispisuje na ekranu tekst upisan od strane korisnika
print "Pritisnite Enter za zatvaranje programa." # ispisuje zahtjev
korisniku da pritisne Enter za izlaz
raw_input() # poziva funkciju za korisnicki unos, a iz programa se
izlazi nakon sto korisnik pritisne Enter
#Ovo je kraj programa i ujedno zadnji komentar
Savjet: Ne pretjerujte s komentarima. Upotrebljavajte ih samo na početku
programa ako zelite na početku programa pisati neke kratke informacije o
programu i sl, te na mjestima gdje mislite da je kod zakompliciran pa ga
treba malo pojasniti.
Kao i u drugim programskim jezicima, u Pythonu je dozvoljeno i
komentiranje u više redova, što možemo postignuti pomoću više-linijskih
stringova koje smo objašnjavali ranije. Dakle, za takve komentare
upotrebljavamo tri dvostruka navodnika (""") ili tri apostrofa (''') za
početak i za kraj komentara. Primjer:
"""
Program verzija 1
Copyright 3000 Mars d.o.o.
Opasno po zivot ne pokreci!
"""
print "U redu, pucam!"
U ovom primjeru dakle, sve je unutar komentara osim zadnje linije gdje
je napisan kod print "U redu, pucam!". Još jednom upozoravam da obavezno
zatvorite više-linijski komentar koristeći trostruke navodnike prije
nego što nastavite pisati kod koji treba izvršiti, jer sve što napišete
između trostrukih navodnika bit će ignorirano i priznavat će se kao
komentar.