Comentarios

Puedes ver este capítulo en inglés en YouTube

Los comentarios son para que los lean los programadores, no el ordenador. es bueno escribir comentarios para ayudar a otras personas a entender tu código. Es bueno, también, para ayudarte a entender tu propio código pasado un tiempo (Muchas personas escriben buen código, pero olvidan porqué lo escribieron). Para escribir comentarios en el código, en Rust se suele usar //:

fn main() {
    // Los programas Rust comienzan en fn main()
    // Pones el código en un bloque que comienza con { y termina con }
    let algun_numero = 100; // Aquí podemos esribir todo lo que queramos ya que el compilador no lo va mirar
}

Cuando lo haces así, el compilador no mirará nada que haya a la derecha de //.

Existe otra clase de comentario que se escribe con /* para iniciarlo y se termina con `*/. Este tipo de comentario es útil para escribirlo entre el código.

fn main() {
    let algun_numero/*: i16*/ = 100;
}

Para el compilador let algun_numero/*: i16*/ = 100; es igual que let algun_numero = 100;.

Esta forma /* */ también es útil para los comentarios de gran longitud que necesiten más de una línea. En este ejemplo se puede ver que necesitas escribir // en cada línea, pero si utilizas /*, el comentario dura hasta que lo finalices con */.

fn main() {
    let algun_numero = 100; /* Déjame contarte
    un poco sobre este número.
    Es el 100, que es mi número favorito.
    Se llama algun_numero pero realmente creo que...*/

    let algun_numero = 100; // Déjame contarte
    // un poco sobre este número.
    // Es el 100, que es mi número favorito.
    // Se llama algun_numero pero realmente creo que...
}