Function core::iter::once

pub fn once<T>(value: T) -> Once<T> 

创建一个迭代器，该迭代器只生成一次元素。

这通常用于将单个值适配到其他类型的迭代的 chain() 中。 也许您有一个涵盖几乎所有内容的迭代器，但是您需要一个额外的特殊情况。 也许您有一个可在迭代器上使用的函数，但只需要处理一个值即可。

Examples

基本用法：

use std::iter;

// 一个是最孤独的数字
let mut one = iter::once(1);

assert_eq!(Some(1), one.next());

// 只是一个，这就是我们得到的
assert_eq!(None, one.next());

与另一个迭代器链接在一起。 假设我们要遍历 .foo 目录的每个文件，还要遍历一个配置文件，

.foorc:

use std::iter;
use std::fs;
use std::path::PathBuf;

let dirs = fs::read_dir(".foo").unwrap();

// 我们需要将 DirEntry-s 的迭代器转换为 PathBufs 的迭代器，因此我们使用 map
let dirs = dirs.map(|file| file.unwrap().path());

// 现在，我们的迭代器仅用于我们的配置文件
let config = iter::once(PathBuf::from(".foorc"));

// 将两个迭代器链接到一个大迭代器中
let files = dirs.chain(config);

// 这将为我们提供 .foo 和 .foorc 中的所有文件
for f in files {
    println!("{f:?}");
}