搜索路径 Crate

提供一个非常简单的搜索路径文件查找器。

SearchPath 类型允许通过一系列搜索目录来查找文件。这与 shell 使用 PATH 环境变量查找可执行文件的机制类似。它可以由环境变量、字符串或字符串/ Path/PathBuf 值的列表构造。通常，find 方法返回第一个匹配的文件或目录，但 find_all 方法专门收集并返回所有匹配路径的列表。

构造函数

SearchPath 类型还实现了 PathBuf、Vec<PathBuf>、Vec<&Path>、Vec<&str>、String 和 &str 的 From<> 实现。在向量值的情况下，或单个 PathBuf，每个路径值将按原样使用，而不会尝试将其拆分成组件。在单个 String 和 &str 值的情况下，值将使用平台特定的路径分隔符拆分成单独的路径组件。

示例

以下示例展示了在命令行中查找可执行命令的常见模式。

use search_path::SearchPath;
use std::path::PathBuf;

fn which_command(cmd_name: &str) -> Option<PathBuf> {
    let search_path = SearchPath::new("PATH").unwrap();
    search_path.find_file(&PathBuf::from(cmd_name))
}

变更

版本 0.1.4

• 添加了新的构造函数 path，作为简单的快捷方式。

版本 0.1.3

• 实现了 IntoIterator 以提取路径。

版本 0.1.2

• 添加了去重方法。

版本 0.1.1

• 完成文档。
• 添加了 Github 构建。
• 修复了 Windows 构建测试用例中的错误。

版本 0.1.0

• 初次提交。