Kommentit Rubiini koodi ovat muistiinpanoja ja huomautuksia, jotka on tarkoitettu muiden ohjelmoijien lukemiseen. Ruby-tulkki ei huomioi itse kommentteja, joten kommenttien sisäiseen tekstiin ei sovelleta rajoituksia.
Tavallisesti on hyvä muoto antaa kommentteja luokkiin ja menetelmiin sekä kaikki koodin osat, jotka voivat olla monimutkaisia tai epäselviä.
Kommenttien tehokas käyttö
Kommentteja tulisi käyttää taustatietojen antamiseen tai vaikean koodin merkitsemiseen. Muistiinpanot, jotka sanovat yksinkertaisesti sen, mitä seuraava suoraviivainen rivi tekee, eivät ole vain ilmeisiä, vaan myös lisäävät sotkuisuutta tiedostoon.
On tärkeää olla varovainen, ettet käytä liian monta kommenttia ja varmista, että tiedostoon tehdyt kommentit ovat merkityksellisiä ja hyödyllisiä muille ohjelmoijille.
Shebang
Huomaat, että kaikki Ruby-ohjelmat alkavat kommentilla, joka alkaa #!. Tätä kutsutaan a jittu ja sitä käytetään Linux-, Unix- ja OS X -järjestelmissä.
Kun suoritat Ruby-komentosarjan, kuori (kuten bash Linuxissa tai OS X) etsii shebangin tiedoston ensimmäisellä rivillä. Kuori käyttää sitten shebangia löytääksesi Ruby-tulkin ja suorittaa komentosarjan.
Edullinen Ruby-shebang on #! / usr / bin / env ruby, vaikka saatat myös nähdä #! / Usr / bin / rubiini tai #! / Usr / local / bin / rubiini.
Yksiriviset kommentit
Yksirivinen Ruby-kommentti alkaa # merkki ja päättyy rivin loppuun. Kaikki merkit # Ruby-tulkki sivuuttaa merkin rivin loppuun.
# merkin ei tarvitse välttämättä esiintyä rivin alussa; se voi tapahtua missä tahansa.
Seuraava esimerkki kuvaa kommenttien muutamaa käyttöä.
#! / usr / bin / env ruby
# Rubyn tulkki ohittaa tämän rivin
# Tämä menetelmä tulostaa argumenttien summan
def summa (a, b)
asettaa + b
pää
summa (10,20) # Tulosta summa 10 ja 20
Moniriviset kommentit
Vaikka monet Ruby-ohjelmoijat ovat unohtaneet sen usein, sillä on monirivisiä kommentteja. Monirivinen kommentti alkaa = alkaa merkki ja päättyy = loppu token.
Näiden merkkien tulisi alkaa rivin alusta ja olla ainoita rivillä. Ruby-tulkki ei huomioi mitään näiden kahden merkin välillä.
#! / usr / bin / env ruby
= alkaa
= Alkamisen ja lopun välillä, mikä tahansa luku
rivejä voidaan kirjoittaa. Kaikki näistä
Ruby-tulkki ei huomioi rivejä.
= loppu
laittaa "Hei maailma!"
Tässä esimerkissä koodi toimisi nimellä Hei maailma!