Rust基础学习笔记（三）：编写一个完整的检索程序

今天主要按照Rust圣经的步骤一步一步创建一个简单的文件中检索关键词程序。运用从前学习的知识的同时还有一些新的技巧和知识，摘录如下：

代码布局原则：

主函数只包含基本的调用函数和返回错误，所有的逻辑部分放进同目录下的lib.rs里

测试函数同样也放在lib.rs里.

测试导向编程：

在编写新功能时，可以先编写测试预计功能的测试函数，之后通过调试功能函数使其通过测试。这样就能够简单易懂的完成功能函数的编写。

错误处理：

1.对于返回Result结构的函数，可以利用unwrap_or_not来解包或处理错误。其中还用到了闭包的知识。

let config = Config::new(&args).unwrap_or_else(|err|{
        eprintln!("Problem parsing arguments: {}",err);
        process::exit(1)
    });

2.返回Result函数时可以选择使用Trait对象搭配问号表达式。

pub fn run(config: Config) -> Result<(),Box<dyn Error>>{
    let contents = fs::read_to_string(config.filename)?;
        ...
}

3.使用eprintln!函数输出至标准错误流

（例见1.）

to_uppercase/to_lowercase的返回值是String对象

注意到要与&str的参数类型匹配，在传参的时候用了引用。

环境变量

配置：powershell中输入 $ env:NAME = VALUE 

使用：

 env::var("NAME") 以引用值，后加.iserr()使其当未设定此环境变量时返回true，设定时返回false: env::var("NAME").iserr() 

杂项

Linux语法（？） '>'指向标准输出流的输出文件：

cargo run to poem.txt > output.txt

完整源代码

*本代码完全按照Rust圣经的指导写出。

./src/main.rs

use std::env;
use std::process;

use minigrep::Config;

fn main() {
    let args: Vec<String> = env::args().collect();

    let config = Config::new(&args).unwrap_or_else(|err|{
        eprintln!("Problem parsing arguments: {}",err);
        process::exit(1)
    });

    println!("Searching for {}",config.query);
    println!("In file {}",config.filename);

    if let Err(e) = minigrep::run(config){
        eprintln!("Application error: {}", e);

        process::exit(1);
    }

}

./src/lib.rs

use std::error::Error;
use std::fs;
use std::env;

pub struct Config{
    pub query: String,
    pub filename: String,
    pub case_sensitive: bool,
}

impl Config {
    pub fn new(args: &[String]) -> Result<Config, &'static str>{
        if args.len() < 3 {
            return Err("Not enough arguments!")
        }
        let query = args[1].clone();
        let filename = args[2].clone();

        let case_sensitive = env::var("CASE_INSENSITIVE").is_err();

        Ok(Config { query, 
                    filename,
                    case_sensitive, })
    }
}

pub fn run(config: Config) -> Result<(),Box<dyn Error>>{
    let contents = fs::read_to_string(config.filename)?;

    let results = if config.case_sensitive {
        search(&config.query, &contents)
    } else {
        search_case_insensitive(&config.query, &contents)
    };

    for line in results {
        println!("{}", line);
    }

    Ok(())
}

pub fn search<'a>(query: &str, contents: &'a str) ->Vec<&'a str>{
    let mut results = Vec::new();
    
    for line in contents.lines(){
        if line.contains(query){
            results.push(line);
        }
    }

    results
}

pub fn search_case_insensitive<'a>(query: &str, contents: &'a str) ->Vec<&'a str>{
    let mut results = Vec::new();
    let query = query.to_lowercase();
    
    for line in contents.lines(){
        if line.to_lowercase().contains(&query){
            results.push(line);
        }
    }

    results
}

#[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));
    }
}

./poem.txt 为 Emily Dickinson 的诗歌 I'm Nobody! Who are you?

I’m nobody! Who are you?
Are you nobody, too?
Then there’s a pair of us - don’t tell!
They’d banish us, you know.

How dreary to be somebody!
How public, like a frog
To tell your name the livelong day
To an admiring bog!

通过此小程序，大致知晓创建小型项目的基本步骤，盖Rust学习中一路标点，故记之。