相关文章推荐
稳重的凉茶  ·  Matlab 之meshgrid, ...·  4 月前    · 
成熟的番茄  ·  TransactionSynchroniza ...·  9 月前    · 
粗眉毛的电池  ·  android入门 — ...·  1 年前    · 
忧郁的路灯  ·  Tailwind Transform - 简书·  1 年前    · 

在 Rust 中使用 // 可以使其之后到第一个换行符的内容变成注释。

在这种规则下,三个正斜杠 /// 依然是合法的注释开始。所以 Rust 可以用 /// 作为说明文档注释的开头:

/// Adds one to the number given.
/// # Examples
/// ```
/// let x = add(1, 2);
/// ```
fn add ( a : i32 , b : i32 ) -> i32 {
return a + b ;
fn main ( ) {
println ! ( "{}" , add ( 2 , 3 ) ) ;

程序中的函数 add 就会拥有一段优雅的注释,并可以显示在 IDE 中:

Tip: Cargo 具有 cargo doc 功能,开发者可以通过这个命令将工程中的说明注释转换成 HTML 格式的说明文档。