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