Trait core::iter::TrustedLen

pub unsafe trait TrustedLen: Iterator { }

🔬 This is a nightly-only experimental API. (trusted_len #37572)

一个使用 size_hint 报告准确长度的迭代器。

迭代器报告一个大小提示，该提示要么是精确的 (下限等于上限)，要么上限是 None。

如果实际的迭代器长度大于 usize::MAX，则上限必须仅为 None。 在这种情况下，下限必须为 usize::MAX，从而导致 Iterator::size_hint() 为 (usize::MAX, None)。

迭代器必须精确地生成它所报告或发散的元素数量，然后才能结束。

Safety

只有在遵守契约的情况下才能实现 trait。 trait 的使用者必须检查 [Iterator::size_hint () ] 的上限。

Implementors

impl TrustedLen for Bytes<'_>

impl<'a, I, T: 'a> TrustedLen for Cloned<I> where
    I: TrustedLen<Item = &'a T>,
    T: Clone, 

impl<'a, I, T: 'a> TrustedLen for Copied<I> where
    I: TrustedLen<Item = &'a T>,
    T: Copy, 

impl<'a, T, I, F, const N: usize> TrustedLen for FlatMap<I, &'a [T; N], F> where
    I: TrustedLen,
    F: FnMut(I::Item) -> &'a [T; N], 

impl<'a, T, I, F, const N: usize> TrustedLen for FlatMap<I, &'a mut [T; N], F> where
    I: TrustedLen,
    F: FnMut(I::Item) -> &'a mut [T; N], 

impl<A> TrustedLen for core::option::IntoIter<A>

impl<A> TrustedLen for core::option::Iter<'_, A>

impl<A> TrustedLen for core::option::IterMut<'_, A>

impl<A> TrustedLen for core::result::IntoIter<A>

impl<A> TrustedLen for core::result::Iter<'_, A>

impl<A> TrustedLen for core::result::IterMut<'_, A>

impl<A, B> TrustedLen for Chain<A, B> where
    A: TrustedLen,
    B: TrustedLen<Item = A::Item>, 

impl<A, B> TrustedLen for Zip<A, B> where
    A: TrustedLen,
    B: TrustedLen, 

impl<A, F: FnMut() -> A> TrustedLen for RepeatWith<F>

impl<A, F: FnOnce() -> A> TrustedLen for OnceWith<F>

impl<A: Clone> TrustedLen for Repeat<A>

impl<A: TrustedStep> TrustedLen for Range<A>

impl<A: TrustedStep> TrustedLen for RangeFrom<A>

impl<A: TrustedStep> TrustedLen for RangeInclusive<A>

impl<B, I, F> TrustedLen for Map<I, F> where
    I: TrustedLen,
    F: FnMut(I::Item) -> B, 

impl<I> TrustedLen for Enumerate<I> where
    I: TrustedLen, 

impl<I> TrustedLen for Flatten<I> where
    I: TrustedLen,
    <I as Iterator>::Item: TrustedConstSize, 

impl<I> TrustedLen for Fuse<I> where
    I: TrustedLen, 

impl<I> TrustedLen for Peekable<I> where
    I: TrustedLen, 

impl<I> TrustedLen for Rev<I> where
    I: TrustedLen + DoubleEndedIterator, 

impl<I: TrustedLen + ?Sized> TrustedLen for &mut I

impl<I: TrustedLen> TrustedLen for Take<I>

impl<T> TrustedLen for Chunks<'_, T>

impl<T> TrustedLen for ChunksExact<'_, T>

impl<T> TrustedLen for ChunksExactMut<'_, T>

impl<T> TrustedLen for ChunksMut<'_, T>

impl<T> TrustedLen for core::slice::Iter<'_, T>

impl<T> TrustedLen for core::slice::IterMut<'_, T>

impl<T> TrustedLen for RChunks<'_, T>

impl<T> TrustedLen for RChunksExact<'_, T>

impl<T> TrustedLen for RChunksExactMut<'_, T>

impl<T> TrustedLen for RChunksMut<'_, T>

impl<T> TrustedLen for Windows<'_, T>

impl<T> TrustedLen for Empty<T>

impl<T> TrustedLen for Once<T>

impl<T, I, F, const N: usize> TrustedLen for FlatMap<I, [T; N], F> where
    I: TrustedLen,
    F: FnMut(I::Item) -> [T; N], 

impl<T, const N: usize> TrustedLen for core::array::IntoIter<T, N>

impl<T, const N: usize> TrustedLen for ArrayChunks<'_, T, N>

impl<T, const N: usize> TrustedLen for ArrayChunksMut<'_, T, N>