当前位置: 代码迷 >> 综合 >> Rust 注释
  详细解决方案

Rust 注释

热度:20   发布时间:2023-12-12 15:23:11.0

Rust 注释

原文地址:https://www.runoob.com/rust/rust-comments.html

1. 普通注释

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

// 这是第一种注释方式/* 这是第二种注释方式 */ /* * 多行注释* 多行注释* 多行注释*/ 

2. 用于说明文档的注释

在 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 格式的说明文档。