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.