Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Comentários

Comentários são usados para documentar seu código, tornando-o mais compreensível para você e outros desenvolvedores. Eles são ignorados pelo compilador, o que significa que não afetam como seu programa é executado, apenas a sua legibilidade.

//

#![allow(unused)]
fn main() {
// Este é um comentário de linha única.
}

/* */

#![allow(unused)]
fn main() {
/*
  ...
  Este é um comentário de múltiplas linhas.
  ...
*/
}

///

#![allow(unused)]
fn main() {
/// Comentários de documentação (doc comments):
///  - Geram documentação automaticamente: cargo doc;
///  - São compatíveis com markdown;
///  - Documentam o item seguinte: função, módulo, struct, etc.
}

//!

#![allow(unused)]
fn main() {
//! Comentário de documentação interno (inner doc comment):
//!  - Documenta módulos/crates: lib.rs;
//!  - Colocado no início dos arquivos.
}

/* // /**/ */

#![allow(unused)]
fn main() {
/* Comentários aninhados (nested comments):
    // Rust permite comentários dentro do bloco de comentário.
    /* ... */
*/
}