目录

7. 注释与基本输入输出

学习目标

注释

单行注释

snippet.rust
// 这是单行注释
let x = 5; // 注释也可以放在行尾

多行注释

snippet.rust
/*
 * 这是多行注释
 * 每行前面加 * 是风格,不是必须
 */

文档注释

文档注释用 ///,支持 Markdown,可用 cargo doc 生成文档:

snippet.rust
/// 计算两个数的和
///
/// # 示例
///
/// ```
/// let sum = add(1, 2);
/// ```
fn add(a: i32, b: i32) -> i32 {
    a + b
}

模块级文档用 //!:

snippet.rust
//! 这个 crate 提供了基础数学工具

`println!` 格式化

基本用法

snippet.rust
println!("Hello, world!");
println!("x = {}", x);

位置参数

snippet.rust
println!("{0} + {1} = {2}", 1, 2, 3);

命名参数

snippet.rust
println!("{subject} {verb} {object}",
         subject = "the quick brown fox",
         verb = "jumps over",
         object = "the lazy dog");

格式化控制

snippet.rust
println!("Number: {:.2}", 3.14159); // 3.14
println!("{:08}", 7); // 00000007
println!("{:b}", 10); // 1010

标准输入

使用 std::io 读取输入:

snippet.rust
use std::io;
 
fn main() {
    println!("请输入一个数字:");
 
    let mut input = String::new();
 
    io::stdin()
        .read_line(&mut input)
        .expect("Failed to read line");
 
    let input: i32 = input
        .trim()
        .parse()
        .expect("Please type a number!");
 
    println!("你输入的是: {}", input);
}

这段代码涉及借用和 Result 处理,将在后续课程深入。

小练习

  1. 给你之前的函数添加文档注释,用 cargo doc --open 查看效果。
  2. 用 println! 格式化打印圆周率到小数点后 4 位。
  3. 编写一个读取用户输入并回显的程序。

小结