Comentarios
Cualquier programa requiere comentarios, y Rust admite algunas variedades diferentes:
- Comentarios regulares que el compilador ignora:
// Comentarios de línea que van al final de la línea./* Comentarios de bloque que van al delimitador de cierre. */
- Comentarios de Doc que se parsean en la librería HTML [documentation](../ meta/doc.md):
/// Genera docs de librería para el siguiente elemento.//! Genera docs de librería para el artículo adjunto.
fn main() { // Este es un ejemplo de un comentario de línea. // Hay dos slashes al comienzo de la línea. // y nada escrito después de estos será leído por el compilador. // println!("Hello, world!"); // Ejecútalo. ¿Ves? Ahora intenta eliminar las dos barras y ejecútalo nuevamente. /* orte * Este es otro tipo de comentario, un comentario en bloque. En general, * los comentarios de línea son el estilo de comentarios recomendado. Pero los comentarios de bloque * son extremadamente útiles para deshabilitar temporalmente los segmentos de código. * /* Los comentarios de bloque pueden ser /* anidados, */ */ por lo que solo se necesitan unos pocos * teclazos para comentar todo en esta función main(). * /*/*/*¡Pruébalo! */*/*/ */ /* Nota: la columna anterior a `*` es completamente por estilo. No hay hay necesidad real para ello. */ // Here's another powerful use of block comments: you can uncomment // and comment a whole block by simply adding or removing a single // '/' character: /* <- add another '/' before the 1st one to uncomment the whole block println!("Now"); println!("everything"); println!("executes!"); // line comments inside are not affected by either state // */ // Puede manipular expresiones más fácilmente con comentarios de bloque // que con comentarios de línea. Intente eliminar los delimitadores de comentarios // para cambiar el resultado: let x = 5 + /* 90 + */ 5; println!("¿Es `x` 10 ó 100? x = {}", x); }