Explicação e Anotação de Comentários em Rust

Beginner

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

Introdução

Bem-vindo(a) a Comments. Este laboratório faz parte do Livro de Rust. Você pode praticar suas habilidades em Rust no LabEx.

Neste laboratório, você aprenderá sobre comentários em Rust e como eles são usados para fornecer explicações e anotações no código-fonte para melhor compreensão.

Este é um Lab Guiado, que fornece instruções passo a passo para ajudá-lo a aprender e praticar. Siga as instruções cuidadosamente para completar cada etapa e ganhar experiência prática. Dados históricos mostram que este é um laboratório de nível iniciante com uma taxa de conclusão de 100%. Recebeu uma taxa de avaliações positivas de 100% dos estudantes.

Comentários

Todos os programadores se esforçam para tornar seu código fácil de entender, mas às vezes uma explicação extra é justificada. Nesses casos, os programadores deixam comentários em seu código-fonte que o compilador ignorará, mas que as pessoas que leem o código-fonte podem achar úteis.

Aqui está um comentário simples:

// hello, world

Em Rust, o estilo idiomático de comentário inicia um comentário com duas barras, e o comentário continua até o final da linha. Para comentários que se estendem além de uma única linha, você precisará incluir // em cada linha, assim:

// Então, estamos fazendo algo complicado aqui, longo o suficiente para que precisemos
// de várias linhas de comentários para fazê-lo! Ufa! Esperançosamente, este comentário irá
// explicar o que está acontecendo.

Os comentários também podem ser colocados no final das linhas contendo código:

Nome do arquivo: src/main.rs

fn main() {
    let lucky_number = 7; // Estou com sorte hoje
}

Mas você os verá com mais frequência usados neste formato, com o comentário em uma linha separada acima do código que está anotando:

Nome do arquivo: src/main.rs

fn main() {
    // Estou com sorte hoje
    let lucky_number = 7;
}

Rust também tem outro tipo de comentário, comentários de documentação, que discutiremos em "Publicando um Crate no Crates.io".

Resumo

Parabéns! Você concluiu o laboratório de Comentários. Você pode praticar mais laboratórios no LabEx para aprimorar suas habilidades.