Programación en Rust | Tutorial de Comentarios

Introducción

En este laboratorio, aprendemos sobre los diferentes tipos de comentarios admitidos por Rust, incluyendo comentarios regulares y comentarios de documentación. Los comentarios regulares pueden ser comentarios de línea, que comienzan con dos barras diagonales y se extienden hasta el final de la línea, o comentarios de bloque, que se encierran entre /* y */ y pueden estar anidados. Los comentarios de documentación, por otro lado, se utilizan para generar documentación de biblioteca en HTML y comienzan con /// o //!.

Nota: Si el laboratorio no especifica un nombre de archivo, puede usar cualquier nombre de archivo que desee. Por ejemplo, puede usar main.rs, compilarlo y ejecutarlo con rustc main.rs &&./main.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL rust(("Rust")) -.-> rust/MemorySafetyandManagementGroup(["Memory Safety and Management"]) rust(("Rust")) -.-> rust/ErrorHandlingandDebuggingGroup(["Error Handling and Debugging"]) rust(("Rust")) -.-> rust/BasicConceptsGroup(["Basic Concepts"]) rust(("Rust")) -.-> rust/FunctionsandClosuresGroup(["Functions and Closures"]) rust/BasicConceptsGroup -.-> rust/variable_declarations("Variable Declarations") rust/FunctionsandClosuresGroup -.-> rust/function_syntax("Function Syntax") rust/FunctionsandClosuresGroup -.-> rust/expressions_statements("Expressions and Statements") rust/MemorySafetyandManagementGroup -.-> rust/lifetime_specifiers("Lifetime Specifiers") rust/ErrorHandlingandDebuggingGroup -.-> rust/error_propagation("Error Propagation") subgraph Lab Skills rust/variable_declarations -.-> lab-99185{{"Tipos de Comentarios y Documentación en Rust"}} rust/function_syntax -.-> lab-99185{{"Tipos de Comentarios y Documentación en Rust"}} rust/expressions_statements -.-> lab-99185{{"Tipos de Comentarios y Documentación en Rust"}} rust/lifetime_specifiers -.-> lab-99185{{"Tipos de Comentarios y Documentación en Rust"}} rust/error_propagation -.-> lab-99185{{"Tipos de Comentarios y Documentación en Rust"}} end

Comentarios

Todo programa requiere comentarios, y Rust admite varios tipos diferentes:

Comentarios regulares que son ignorados por el compilador:
- // Comentarios de línea que se extienden hasta el final de la línea.
- /* Comentarios de bloque que se extienden hasta el delimitador de cierre. */
Comentarios de documentación que se analizan en documentación de biblioteca en HTML:
- /// Genera documentación de biblioteca para el siguiente elemento.
- //! Genera documentación de biblioteca para el elemento que los envuelve.

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

    // println!("Hello, world!");

    // Ejecútalo. ¿Ves? Ahora intenta eliminar las dos barras diagonales y ejecútalo de nuevo.

    /*
     * Este es otro tipo de comentario, un comentario de bloque. En general,
     * los comentarios de línea son el estilo de comentario recomendado. Pero los comentarios de bloque
     * son extremadamente útiles para deshabilitar temporalmente trozos de código.
     * /* Los comentarios de bloque pueden ser /* anidados, */ */ así que solo se necesitan unos pocos
     * pulsaciones de teclado para comentar todo el código de esta función main().
     * /*/*/* Prueba hacerlo tú mismo! */*/*/
     */

    /*
    Nota: La columna anterior de `*` era solo para estilo. No es realmente necesaria.
    */

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

Resumen

¡Felicitaciones! Has completado el laboratorio de Comentarios. Puedes practicar más laboratorios en LabEx para mejorar tus habilidades.