Explicación y anotación de comentarios en Rust

Beginner

This tutorial is from open-source community. Access the source code

Introducción

Bienvenido a Comentarios. Esta práctica es parte del Rust Book. Puedes practicar tus habilidades de Rust en LabEx.

En esta práctica, aprenderás sobre los comentarios en Rust y cómo se utilizan para proporcionar explicaciones y anotaciones en el código fuente para una mejor comprensión.

Este es un Guided Lab, que proporciona instrucciones paso a paso para ayudarte a aprender y practicar. Sigue las instrucciones cuidadosamente para completar cada paso y obtener experiencia práctica. Los datos históricos muestran que este es un laboratorio de nivel principiante con una tasa de finalización del 100%. Ha recibido una tasa de reseñas positivas del 100% por parte de los estudiantes.

Comentarios

Todos los programadores tratan de hacer que su código sea fácil de entender, pero a veces es necesario una explicación adicional. En estos casos, los programadores dejan comentarios en su código fuente que el compilador ignorará, pero que las personas que lean el código fuente pueden encontrar útiles.

Aquí hay un comentario simple:

// hello, world

En Rust, el estilo de comentario idiómatizado comienza un comentario con dos barras diagonales, y el comentario continúa hasta el final de la línea. Para comentarios que se extienden más allá de una sola línea, tendrás que incluir // en cada línea, como esto:

// Entonces, estamos haciendo algo complicado aquí, lo suficientemente largo como para que necesitemos
// múltiples líneas de comentarios para hacerlo. ¡Uy! Espero que este comentario
// explique lo que está pasando.

Los comentarios también se pueden colocar al final de las líneas que contienen código:

Nombre del archivo: src/main.rs

fn main() {
    let lucky_number = 7; // Estoy sintiéndome afortunado hoy
}

Pero más a menudo los verás utilizados en este formato, con el comentario en una línea separada encima del código que está anotando:

Nombre del archivo: src/main.rs

fn main() {
    // Estoy sintiéndome afortunado hoy
    let lucky_number = 7;
}

Rust también tiene otro tipo de comentario, los comentarios de documentación, que discutiremos en "Publicando un Caja a Crates.io".

Resumen

¡Felicitaciones! Has completado la práctica de Comentarios. Puedes practicar más prácticas en LabEx para mejorar tus habilidades.