Rust comments: Difference between revisions

From wikinotes
(Created page with "{{ TODO | verify and expand on doc comments }} <syntaxhighlight lang="rust"> // inline comment </syntaxhighlight> <syntaxhighlight lang="rust"> →‎multiline * comment: <...")
 
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{ TODO |
= Regular Comments =
verify and expand on doc comments }}
<blockquote>
 
<syntaxhighlight lang="rust">
<syntaxhighlight lang="rust">
// inline comment
// inline comment
Line 11: Line 10:
  */
  */
</syntaxhighlight>
</syntaxhighlight>
</blockquote><!-- Regular Comments -->
= Annotation Comments =
<blockquote>
Variable assignments can be annotated
<syntaxhighlight lang="rust">
// This number is used because...
let magic_number = 123;
</syntaxhighlight>
</blockquote><!-- Annotation Comments -->
= Doc Comments =
<blockquote>
There are two styles of doc-comments:


<syntaxhighlight lang="rust">
<syntaxhighlight lang="rust">
/// doc-comment for following item (ex: java style)
//! document enclosing item (typically used for crates, modules)
fn foo() {
    println!("hi")
}


fn foo() {
/// document following item (typically used for objects, functions)
    //! doc-comment for enclosing item (ex: python style)
    println!("bye")
}
</syntaxhighlight>
</syntaxhighlight>
For more details, see [[rust documentation]].
</blockquote><!-- Doc Comments -->

Latest revision as of 21:17, 9 February 2023

Regular Comments

// inline comment
/* multiline
 * comment
 */

Annotation Comments

Variable assignments can be annotated

// This number is used because...
let magic_number = 123;

Doc Comments

There are two styles of doc-comments:

//! document enclosing item (typically used for crates, modules)

/// document following item (typically used for objects, functions)

For more details, see rust documentation.