当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Rust Iterator.size_hint用法及代码示例


本文简要介绍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-lang.org大神的英文原创作品 std::iter::Iterator.size_hint。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。