本文简要介绍rust语言中 std::iter::Iterator.size_hint
的用法。
用法
fn size_hint(&self) -> (usize, Option<usize>)
返回迭代器剩余长度的边界。
具体来说,size_hint()
返回一个元组,其中第一个元素是下限,第二个元素是上限。
返回的元组的后半部分是 Option<usize>
。此处的 None
表示没有已知的上限,或者上限大于 usize
。
实施说明
不强制迭代器实现产生声明的元素数量。有缺陷的迭代器产生的结果可能小于元素的下限或大于元素的上限。
size_hint()
主要用于优化,例如为迭代器的元素保留空间,但不能信任,例如,在不安全的代码中省略边界检查。 size_hint()
的错误实现不应导致内存安全违规。
也就是说,实现应该提供正确的估计,否则它将违反 trait 的协议。
默认实现返回 (0, None)
这对于任何迭代器都是正确的。
例子
基本用法:
let a = [1, 2, 3];
let iter = a.iter();
assert_eq!((3, Some(3)), iter.size_hint());
一个更复杂的例子:
// The even numbers in the range of zero to nine.
let iter = (0..10).filter(|x| x % 2 == 0);
// We might iterate from zero to ten times. Knowing that it's five
// exactly wouldn't be possible without executing filter().
assert_eq!((0, Some(10)), iter.size_hint());
// Let's add five more numbers with chain()
let iter = (0..10).filter(|x| x % 2 == 0).chain(15..20);
// now both bounds are increased by five
assert_eq!((5, Some(15)), iter.size_hint());
返回None
的上限:
// an infinite iterator has no upper bound
// and the maximum possible lower bound
let iter = 0..;
assert_eq!((usize::MAX, None), iter.size_hint());
相关用法
- Rust Iterator.skip_while用法及代码示例
- Rust Iterator.scan用法及代码示例
- Rust Iterator.skip用法及代码示例
- Rust Iterator.sum用法及代码示例
- Rust Iterator.step_by用法及代码示例
- Rust Iterator.max_by_key用法及代码示例
- Rust Iterator.is_sorted用法及代码示例
- Rust Iterator.cmp用法及代码示例
- Rust Iterator.is_partitioned用法及代码示例
- Rust Iterator.intersperse用法及代码示例
- Rust Iterator.min用法及代码示例
- Rust Iterator.find_map用法及代码示例
- Rust Iterator.peekable用法及代码示例
- Rust Iterator.rev用法及代码示例
- Rust Iterator.product用法及代码示例
- Rust Iterator.any用法及代码示例
- Rust Iterator.max用法及代码示例
- Rust Iterator.by_ref用法及代码示例
- Rust Iterator.min_by用法及代码示例
- Rust Iterator.copied用法及代码示例
- Rust Iterator.inspect用法及代码示例
- Rust Iterator.min_by_key用法及代码示例
- Rust Iterator.intersperse_with用法及代码示例
- Rust Iterator.flat_map用法及代码示例
- Rust Iterator.ge用法及代码示例
注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::iter::Iterator.size_hint。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。