Trait _IterTrait

Source

pub trait _IterTrait<'a, T>:
    Iterator<Item = T, Item = T>
    + ExactSizeIterator
    + DoubleEndedIterator
    + CloneDynwhere
    T: 'a,
{ }

Expand description

Trait that encapsulates an iterator with specific characteristics and implemetning CloneDyn.

The _IterTrait trait is designed to represent iterators that may yield references to items ( &'a T ). These iterators must also implement the ExactSizeIterator and DoubleEndedIterator traits. This combination ensures that the iterator can:

Provide an exact size hint ( ExactSizeIterator ),
Be traversed from both ends ( DoubleEndedIterator ).

Additionally, the iterator must implement the CloneDyn trait, which allows cloning of trait objects.

§Example

use iter_tools::_IterTrait;

// Example struct that implements Iterator, ExactSizeIterator, DoubleEndedIterator, and CloneDyn.
#[ derive( Clone ) ]
struct MyIterator
{
  // internal fields
}

impl Iterator for MyIterator
{
  type Item = i32;

  fn next( &mut self ) -> Option<  Self::Item  >
  {
    // implementation
    Some( 1 )
  }
}

impl ExactSizeIterator for MyIterator
{
  fn len( &self ) -> usize
  {
    // implementation
    1
  }
}

impl DoubleEndedIterator for MyIterator
{
  fn next_back( &mut self ) -> Option<  Self::Item  >
  {
    // implementation
    Some( 1 )
  }
}