阅读 164

Rust 注释

Rust 中的注释方式与其它语言(C、Java)一样,支持两种注释方式:

示例

// 这是第一种注释方式

/* 这是第二种注释方式 */ 

/*  * 多行注释 * 多行注释 * 多行注释
 */

用于说明文档的注释

在 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 中:

图片.png

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


文章分类
代码人生
文章标签
版权声明:本站是系统测试站点,无实际运营。本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 XXXXXXo@163.com 举报,一经查实,本站将立刻删除。
相关推荐