Il Linguaggio di Programmazione Rust

Commenti

Tutti i programmatori si impegnano a rendere il loro codice facile da comprendere, ma a volte è giustificata una spiegazione extra. In questi casi, i programmatori lasciano commenti nel loro codice sorgente che il compilatore ignorerà ma che le persone che leggono il codice sorgente potrebbero trovare utili.

Ecco un semplice commento:

#![allow(unused)]
fn main() {
// hello, world
}

In Rust, lo stile idiomatico dei commenti inizia un commento con due barre, e il commento continua fino alla fine della riga. Per i commenti che si estendono oltre una singola riga, sarà necessario includere // su ciascuna riga, come questo:

#![allow(unused)]
fn main() {
// Stiamo facendo qualcosa di complicato qui, abbastanza lungo da
// richiedere più righe di commenti per farlo! Uff! Si spera che questo commento
// spieghi cosa sta succedendo.
}

I commenti possono essere posizionati anche alla fine delle righe contenenti il codice:

Filename: src/main.rs

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

Ma più spesso li vedrete utilizzati in questo formato, con il commento su una linea separata sopra il codice che annota:

Filename: src/main.rs

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

Rust ha anche un altro tipo di commento, commenti di documentazione, che discuteremo nella sezione “Pubblicazione di un Crate su Crates.io” del Capitolo 14.