Rust / 系统课时

实现核心流程

实现核心流程

本课把一个最小文本处理工具串起来:读取文件、逐行迭代、过滤数据、汇总结果,并用 Result 与 ? 把 I/O 错误向上传播。最终得到一条可运行、可验证且便于扩展的核心处理链路。

学习目标

  • 用 BufReader 和 lines 逐行读取文本文件
  • 用迭代器完成过滤和计数,避免手写多余状态
  • 用 Result 与 ? 传播文件读取错误,并在程序入口统一处理

明确核心处理链路

这个工具只做一件事:统计文本文件中长度达到阈值的非空行。核心函数不负责创建文件、不打印日志,只接收路径和配置并返回结果,因此测试和复用都更简单。

处理顺序是“打开文件 → 建立缓冲读取器 → 收集各行 → 过滤空行和短行 → 汇总数量”。其中任何一次读取失败都会通过 ? 立刻返回,不再继续执行后续过滤。

文本处理核心流程与错误传播

组合文件读取与迭代器

BufReader 避免频繁直接访问文件,lines() 则把输入转换成逐行迭代器。下面示例为了可以直接运行,会先写入一个临时文本文件,再调用核心函数读取并统计;真实工具中只需要把路径换成用户传入的文件即可。

rust
use std::fs::{self, File};
use std::io::{self, BufRead, BufReader};

#[derive(Debug)]
struct Config {
    ignore_blank: bool,
    min_len: usize,
}

#[derive(Debug)]
struct ProcessResult {
    matched: usize,
    total: usize,
}

#[derive(Debug)]
enum AppError {
    Io(io::Error),
}

impl From<io::Error> for AppError {
    fn from(error: io::Error) -> Self {
        Self::Io(error)
    }
}

fn process_file(path: &str, config: &Config) -> Result<ProcessResult, AppError> {
    let file = File::open(path)?;
    let reader = BufReader::new(file);

    // 先把每一行的 I/O 结果收集起来;任意一行读取失败都会提前返回。
    let lines = reader.lines().collect::<Result<Vec<_>, _>>()?;
    let total = lines.len();

    // 过滤逻辑保持为纯迭代器链,避免额外维护计数状态。
    let matched = lines
        .into_iter()
        .map(|line| line.trim().to_string())
        .filter(|line| !config.ignore_blank || !line.is_empty())
        .filter(|line| line.len() >= config.min_len)
        .count();

    Ok(ProcessResult { matched, total })
}

fn run() -> Result<(), AppError> {
    let path = "sample.txt";
    fs::write(path, "Rust\nfast\n\nzero-copy\n")?;

    let config = Config {
        ignore_blank: true,
        min_len: 5,
    };
    let result = process_file(path, &config)?;

    println!("total = {}", result.total);
    println!("matched = {}", result.matched);

    fs::remove_file(path)?;
    Ok(())
}

fn main() {
    if let Err(error) = run() {
        eprintln!("error: {error:?}");
        std::process::exit(1);
    }
}

预期输出

text
total = 4
matched = 1

这里一共有 4 行输入,空行会被忽略;Rust 和 fast 长度小于 5,只有 zero-copy 满足条件,因此 matched 为 1。

理解问号运算符的边界

File::open(path)?、收集各行时的 ?、以及 fs::remove_file(path)? 都遵循同一规则:成功时取出内部值继续执行,失败时把错误转换为当前函数的错误类型并立即返回。前提是存在合适的 From 转换,因此示例实现了 From<io::Error> for AppError。

保持核心逻辑可测试

process_file 不解析命令行,也不直接退出进程,它只返回 Result<ProcessResult, AppError>。这种边界让调用方可以决定失败后是打印错误、重试还是转换成其他状态,同时让核心函数保持单一职责。

如果后续要增加不同命令,可以在入口先匹配 Command,再把路径和配置交给对应处理函数。文件读取、迭代器过滤和错误传播仍可以保持不变,扩展点集中在命令分派和具体业务规则上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现核心流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通