使用环境变量实现Rust程序中的不区分大小写搜索方式

 更新时间:2025年02月26日 09:36:20   作者:Hello.Reader  
本文介绍了如何在Rust中实现不区分大小写的搜索功能,并通过测试驱动开发(TDD)方法逐步实现该功能,通过修改运行函数和获取环境变量,程序可以根据环境变量控制搜索模式

步骤 1:编写失败的测试

我们遵循测试驱动开发(TDD)方法,首先编写一个测试来验证不区分大小写搜索功能。由于我们尚未实现该功能,因此这个测试会失败。

以下是测试代码:

#[cfg(test)]
mod tests {
    use super::*;

    // 测试:区分大小写的搜索
    #[test]
    fn case_sensitive() {
        let query = "duct";
        let contents = "\
Rust:
safe, fast, productive.
Pick three.
Duct tape.";

        // 期望返回大小写敏感的匹配结果
        assert_eq!(vec!["safe, fast, productive."], search(query, contents));
    }

    // 测试:不区分大小写的搜索
    #[test]
    fn case_insensitive() {
        let query = "rUsT";  // 查询字符串的大小写不一致
        let contents = "\
Rust:
safe, fast, productive.
Pick three.
Trust me.";

        // 期望返回不区分大小写的匹配结果
        assert_eq!(
            vec!["Rust:", "Trust me."],
            search_case_insensitive(query, contents)
        );
    }
}

在上述代码中:

  • case_sensitive 测试验证了原始的区分大小写的搜索。
  • case_insensitive 测试验证了我们将在后面实现的不区分大小写的搜索。此时,由于我们还没有实现 search_case_insensitive 函数,编译将失败。

步骤 2:实现 search_case_insensitive 函数

为了实现不区分大小写的搜索,我们需要修改 search 函数,使其能够忽略大小写。

以下是 search_case_insensitive 函数的实现:

// 不区分大小写的搜索函数
pub fn search_case_insensitive<'a>(
    query: &str,       // 查询字符串
    contents: &'a str, // 文件内容
) -> Vec<&'a str> {
    let query = query.to_lowercase(); // 将查询字符串转换为小写
    let mut results = Vec::new(); // 存储匹配结果

    // 遍历文件中的每一行
    for line in contents.lines() {
        // 将每一行转换为小写再进行比较
        if line.to_lowercase().contains(&query) {
            results.push(line); // 如果匹配,加入结果列表
        }
    }

    results // 返回匹配的行
}

代码解释:

  • query.to_lowercase() 将查询字符串转换为小写,以确保不区分大小写地进行匹配。
  • line.to_lowercase() 将每一行内容转换为小写,并检查是否包含查询字符串。

步骤 3:修改 run 函数

run 函数是程序的核心,它负责执行搜索并输出结果。我们需要修改 run 函数,使其根据 Config 结构体中的 ignore_case 字段来决定是使用区分大小写的 search 函数,还是不区分大小写的 search_case_insensitive 函数。

// 根据配置运行搜索
pub fn run(config: Config) -> Result<(), Box<dyn Error>> {
    let contents = fs::read_to_string(config.file_path)?; // 读取文件内容

    // 根据 ignore_case 字段决定使用哪种搜索
    let results = if config.ignore_case {
        search_case_insensitive(&config.query, &contents) // 不区分大小写的搜索
    } else {
        search(&config.query, &contents) // 区分大小写的搜索
    };

    // 打印匹配的行
    for line in results {
        println!("{line}");
    }

    Ok(())
}

代码解释:

  • Config 结构体包含一个 ignore_case 字段,用于控制是否启用不区分大小写的搜索。
  • 根据 ignore_case 的值,我们决定调用 search 还是 search_case_insensitive

步骤 4:获取环境变量

现在,我们需要从环境变量中获取 IGNORE_CASE 的值,来决定是否启用不区分大小写的搜索。

我们使用 Rust 标准库中的 env 模块来访问环境变量。

use std::env;

impl Config {
    // 构建 Config 实例
    pub fn build(args: &[String]) -> Result<Config, &'static str> {
        if args.len() < 3 {
            return Err("not enough arguments");
        }

        let query = args[1].clone();
        let file_path = args[2].clone();

        // 检查环境变量 IGNORE_CASE 是否设置
        let ignore_case = env::var("IGNORE_CASE").is_ok(); // 如果环境变量存在,则启用不区分大小写的搜索

        Ok(Config {
            query,
            file_path,
            ignore_case,
        })
    }
}

代码解释:

  • 我们使用 env::var("IGNORE_CASE").is_ok() 来检查环境变量 IGNORE_CASE 是否被设置。
  • 如果设置了该环境变量,我们将 ignore_case 设置为 true,否则默认为 false

步骤 5:运行程序

现在,我们的程序已经支持根据环境变量来控制搜索模式。你可以通过以下命令来运行程序:

  1. 不使用环境变量,执行区分大小写的搜索:
$ cargo run -- to poem.txt
  1. 设置环境变量 IGNORE_CASE=1,启用不区分大小写的搜索:
$ IGNORE_CASE=1 cargo run -- to poem.txt

对于 PowerShell 用户,可以使用以下命令:

PS> $Env:IGNORE_CASE=1; cargo run -- to poem.txt

总结

通过使用环境变量,我们成功地在Rust程序中实现了不区分大小写的搜索功能。

这种方式让用户可以通过简单的环境变量配置来改变程序的行为,而不需要每次运行程序时都指定命令行参数。

通过这种方法,我们可以在命令行工具中灵活地控制不同的搜索模式,使程序更加友好和易于配置。

在本教程中,我们:

  • 通过 TDD 编写了失败的测试,并逐步实现了功能。
  • 学会了如何使用 Rust 标准库中的 env 模块获取环境变量。
  • 通过环境变量控制程序行为,让命令行工具更加灵活。

通过这个示例,希望你对 Rust 中如何使用环境变量有所了解,并能够在自己的项目中灵活应用。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • Rust常用特型之ToOwned特型示例详解

    Rust常用特型之ToOwned特型示例详解

    在Rust中,假定某类型实现了Clone特型,如果给你一个对它引用,那我们得到它指向内容的备份的最常见方式是调用其clone()函数,这篇文章主要介绍了Rust常用特型之ToOwned特型,需要的朋友可以参考下
    2024-04-04
  • Windows下Rust自定义路径安装全攻略【保姆级教程】

    Windows下Rust自定义路径安装全攻略【保姆级教程】

    Rust被设计为能够处理大量的并发和高性能的软件,这使得它适合在游戏开发、操作系统开发、浏览器引擎开发以及嵌入式系统等领域发挥巨大的作用,这篇文章主要介绍了Windows下Rust自定义路径安装的相关资料,需要的朋友可以参考下
    2026-02-02
  • 在Rust中要用Struct和Enum组织数据的原因解析

    在Rust中要用Struct和Enum组织数据的原因解析

    在Rust中,Struct和Enum是组织数据的核心工具,Struct用于将相关字段封装为单一实体,便于管理和扩展,Enum用于明确定义所有可能的状态,本文将通过具体示例,深入探讨为什么在Rust中必须使用struct和enum来管理数据,感兴趣的朋友一起学习吧
    2025-02-02
  • rust中的match表达式使用详解

    rust中的match表达式使用详解

    在rust中提供了一个极为强大的控制流运算符match,这篇文章主要介绍了rust中的match表达式,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-08-08
  • Rust Atomics and Locks 源码解读

    Rust Atomics and Locks 源码解读

    这篇文章主要为大家介绍了Rust Atomics and Locks 源码解读,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-02-02
  • Rust突破编译器限制构造可修改的全局变量

    Rust突破编译器限制构造可修改的全局变量

    这篇文章主要为大家介绍了Rust突破编译器限制构造可修改的全局变量示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • 深入了解Rust中泛型的使用

    深入了解Rust中泛型的使用

    所有的编程语言都致力于将重复的任务简单化,并为此提供各种各样的工具。在 Rust 中,泛型(generics)就是这样一种工具,本文就来聊聊Rust中泛型的使用,需要的可以参考一下
    2022-11-11
  • Rust搭建webserver的底层原理与应用实战技巧

    Rust搭建webserver的底层原理与应用实战技巧

    本文介绍Rust在HTTP编程中的应用,涵盖协议基础、标准库与第三方库(如hyper、reqwest)的使用,以及多线程服务器和线程池的实现与关闭机制,展示Rust在性能、安全和并发方面的优势,感兴趣的朋友跟随小编一起看看吧
    2025-06-06
  • Rust字符串字面值的一些经验总结

    Rust字符串字面值的一些经验总结

    字符串有两种表现形式,一种是基本类型,表示字符串的切片,以&str表示,另一种是可变的string类型,下面这篇文章主要给大家介绍了关于Rust字符串字面值的相关资料,需要的朋友可以参考下
    2022-04-04
  • Rust初体验:手把手教你构建‘Hello, World!’

    Rust初体验:手把手教你构建‘Hello, World!’

    "准备好了吗?一起踏上Rust编程语言的精彩旅程!在这篇「Rust初体验」中,我们将手把手教你构建经典程序“Hello, World!”,感受Rust的强大与安全,短短几行代码,就能让你对这个系统级语言的魅力一探究竟!快加入吧,惊喜等你发现!"
    2024-01-01

最新评论