Rust的注释

提示

如果你学过 C ,C++,java,C#.你可以跳过本节课,为什么,因为Rust的注释和这些语言几乎一样。

什么是注释?

写给人看的说明文字,编译器会忽略,不参与程序运行。

注释的作用有那些?

  • 解释代码功能 :给人看,让代码更好理解
  • 标注编写信息 :用来生成某些文档
  • 临时屏蔽代码 :有些代码不删除,但也不想它执行,可以通过注释临时屏蔽
  • 提升代码可读性

Rust的两/三种注释方式

  • 注释:从//开始并继续到行尾
  • 注释:可以注释一段代码,被封闭在内,可以跨越多行/* ... */

注释,有点类似你读书的时候,在课本上面写的笔记,方便你理解课文。

我们先学习两种常见的注释,后面再学第三种。

fn main() {
    // 单行注释以两个斜杠开头。直到这行的行尾
    // 斜杠后的本行的所有内容都会被编译器忽略。

    // 示例:这行代码不会执行
    // println!("Hello, world!");

    // 试着删除上面的斜杠,再次运行代码。

    /*
     * 块注释可用来临时禁用代码。例如看下面
     * 它还支持嵌套:/* 像这样 */,能快速将大段代码注释掉。
     */

    /*
     * println!("Hello, world!");
     * println!("Hello, world2!");
     */

    /*
    注意:左侧一列星号仅为排版样式,
    并非语言语法要求。你可以不写它的。
    */

    // 只需增删一个斜杠,就能利用块注释快速切换代码启用/禁用状态:

    /* <- 在这里再加一个斜杠,即可解除下方整块注释(意思是 在/*前增加/ ---》//* 读者可以试试)
    
    println!("现在");
    println!("所有");
    println!("代码都会执行!");
    // 内部的单行注释不会受到影响

    // */

    // 块注释也可以写在表达式中间:
    let x = 5 + /* 90 + */ 5;
    println!("`x` 是 10 还是 100?x = {}", x);
}Code language: PHP (php)

以上这段代码,读者拷贝下来,自己试试,特别是/* <- 在这里再加一个斜杠,即可解除下方整块注释

(意思是 在/*前增加/ 变成//* 读者可以试试) 这样等于 这个块注释 少了一个/* 开始的部分,然后后面的// */ 又被// 注释了。

这样就等于临时删除了这个块注释。 中间的 println代码 就可以执行了

文档注释

文档注释,是可以通过工具,把注释的东西生成HTML格式的文档。方便程序员查阅。这个我们下节课,在独立一节课来学习。

  • 这里是文字1

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注