Kommentaarid teie Rubiin kood on märkmed ja märkused, mis on mõeldud teistele programmeerijatele lugemiseks. Ruby tõlk ignoreerib kommentaare ise, seega ei kehti kommentaarides sisalduva teksti suhtes mingeid piiranguid.
Tavaliselt on hea vorm kommentaaride esitamiseks enne klasse ja meetodeid, samuti mis tahes kooditüki jaoks, mis võib olla keeruline või ebaselge.
Kommentaaride tõhus kasutamine
Kommentaare tuleks kasutada taustteabe andmiseks või keeruka koodi märkimiseks. Märkused, mis lihtsalt ütlevad, mida järgmine sirgjooneline kood teeb, pole mitte ainult ilmsed, vaid lisavad failile ka segadust.
Oluline on hoolitseda selle eest, et te ei kasutaks liiga palju kommentaare, ja veenduge, et failis tehtud kommentaarid oleksid tähendusrikkad ja abiks teistele programmeerijatele.
Shebang
Võite märgata, et kõik Ruby programmid algavad kommentaariga, mis algab kuupäevaga #!. Seda nimetatakse a-ks shebang ning seda kasutatakse Linuxi, Unixi ja OS X süsteemides.
Ruby-skripti käivitamisel otsib kest (näiteks bash Linuxis või OS X-is) faili esimesel real shebangi. Seejärel kasutab kest shebangi Ruby tõlgi leidmiseks ja skripti käitamiseks.
Eelistatud on Ruby shebang #! / usr / bin / env rubiin, kuigi võite ka näha #! / usr / prügikast / rubiin või #! / usr / kohalik / prügikast / rubiin.
Üherealised kommentaarid
Rubiini üherealine kommentaar algab tähega # märk ja lõpeb rea lõpus. Mis tahes tähemärki # Ruby tõlk ignoreerib rea lõpuni tähemärki.
# märk ei pea tingimata ilmuma rea alguses; see võib ilmneda kõikjal.
Järgmine näide illustreerib kommentaaride väheseid kasutusviise.
#! / usr / bin / env rubiin
# Ruby tõlk ignoreerib seda rida
# See meetod prindib argumentide summa
def summa (a, b)
paneb + b
lõpp
summa (10,20) # Printige summa 10 ja 20
Mitmerealised kommentaarid
Ehkki paljud Ruby programmeerijad on selle sageli unustanud, on Rubyl siiski mitmerealisi kommentaare. Mitmerealine kommentaar algab tähega = alustada märk ja lõpeb numbriga = lõpp märk.
Need märgid peaksid algama rea alguses ja olema rea ainus asi. Ruby tõlk eirab midagi nende kahe märgi vahel.
#! / usr / bin / env rubiin
= alustada
Vahemikus = algus ja = lõpp, suvaline arv
ridade võib kirjutada. Kõik need
Ruby tõlk ignoreerib ridu.
= lõpp
paneb kirja "Tere maailm!"
Selles näites käivitatakse kood kujul Tere, Maailm!