當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文


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。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。