Comentarii

Toți programatorii se străduiesc să facă codul lor ușor de înțeles, dar uneori este necesară o explicație suplimentară. În aceste cazuri, programatorii lasă comentarii în codul lor sursă pe care compilatorul îl va ignora, dar persoanele care citesc codul sursă le-ar considera utile.

Acesta este un comentariu simplu:

#![allow(unused)]
fn main() {
// salutare, lume
}

În Rust, stilul idiomatic de a scrie comentarii începe cu două liniuțe, și comentariul continuă până la sfârșitul liniei. Pentru comentarii care se extind mai mult decât o linie, va trebui să includeți // pe fiecare linie, așa:

#![allow(unused)]
fn main() {
// Deci facem ceva complex aici, suficient de lung încât avem nevoie
// de mai multe linii de comentarii pentru a face asta! Uff! Sperăm că acest comentariu va 
// clarifica ce se întâmplă.
}

Comentariile pot fi, de asemenea, plasate la sfârșitul liniilor care conțin cod:

Numele fișierului: src/main.rs

fn main() {
    let lucky_number = 7; // I’m feeling lucky today
}

Dar le vei vedea mai des utilizate în acest format, cu comentariul pe o linie separată, deasupra codului pe care îl comentează:

Numele fișierului: src/main.rs

fn main() {
    // I’m feeling lucky today
    let lucky_number = 7;
}

Rust dispune și de un alt tip de comentariu, comentariile de documentare, despre care vom discuta în secțiunea „Publicarea unui crate la crates.io” a Capitolului 14.