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); }