Comentarios

Cualquier programa requiere comentarios y Rust admite algunas variedades diferentes:

• Comentarios regulares que son ignorados por el compilador:

  • // Comentarios de línea que van hasta el final de la línea.
  • /* Comentarios en bloque que van hasta el delimitador de cierre. */

• Comentarios de documentación que se analizan en la documentación HTML de la biblioteca:

  • /// Genera documentación de biblioteca para el siguiente elemento.
  • //! Genera documentación de biblioteca para el elemento adjunto.

fn main() {
    // Este es un ejemplo de un comentario de línea
    // Hay dos barras al principio de la línea
    // Y nada escrito dentro de estas será leído por el compilador

    // println!("¡Hola, mundo!");

    // Ejecútalo. ¿Ves? Ahora intenta eliminar las dos barras y ejecútelo nuevamente.

    /* 
     * Este es otro tipo de comentario, un comentario de bloque. En general,
     * los comentarios de línea son el estilo de comentario recomendado. Pero
     * comentarios de bloque son extremadamente útiles para deshabilitar
     * temporalmente trozos de código. /* Los comentarios de bloque se pueden 
     * /* anidar, */*/ por lo que solo se necesitan algunas pulsaciones para
     * comentar todo en esta función main(). /*/*/* ¡Inténtalo tú mismo! */*/*/
     */

    /*
    Nota: La columna anterior de `*` fue enteramente por estilo. No hay
    necesidad real de ello.
    */

    // Puedes manipular expresiones más fácilmente con comentarios de bloque
    // que con comentarios de línea. Intenta eliminar los delimitadores de
    // comentarios para cambiar el resultado:
    let x = 5 + /* 90 + */ 5;
    println!("`x` es 10 o 100? x = {}", x);
}