7 releases
0.1.6 | Sep 14, 2024 |
---|---|
0.1.5 | Dec 9, 2023 |
0.1.3 | Nov 23, 2023 |
0.1.1 | Aug 16, 2023 |
#196 in Algorithms
3,113 downloads per month
Used in 3 crates
52KB
1.5K
SLoC
Gat Lending Iterator
My concept for what a lending iterator crate should look like. Work in progress.
Most Iterator
methods can work as is on LendingIterator
s, but some wouldn't make sense. Basically any method that needs to look at more than one element at once isn't possible.
Some LendingIterator
methods may return something that can act as an Iterator
. For example cloned
, or map
, when the function passed to it returns a value that isn't tied to the lifetime of its input. In these cases, my design choice was to conditionally implement IntoIterator for the adapter.
I've also included an extension trait ToLendingIterator: IntoIterator
for iterators that allows turning them into lending iterators in various ways, for example over windows of elements. It's possible I will add more methods to this trait.
methods that behave the same on LendingIterator
s as they do on Iterator
s
- advance_by
- all
- any
- by_ref
- chain
- cmp
- cmp_by
- count
- cycle
- enumerate
- eq
- eq_by
- filter
- filter_map
- find
- find_map
- flat_map
- flatten
- fold
- for_each
- fuse
- ge
- gt
- inspect
- intersperse
- intersperse_with
- is_partitioned
- le
- lt
- map
- map_while
- ne
- nth
- partial_cmp
- partial_cmp_by
- position
- product
- scan
- size_hint
- skip
- skip_while
- step_by
- sum
- take
- take_while
- try_find
- try_fold
- try_for_each
- zip
methods that don't make sense on LendingIterator
s
- array_chunks
- collect
- collect_into
- is_sorted
- is_sorted_by
- is_sorted_by_key
- last
- next_chunk
- partition
- partition_in_place
- peekable
- try_collect
- unzip
methods that behave differently on LendingIterator
s
- max
- max_by
- max_by_key
- min
- min_by
- min_by_key
- reduce
- try_reduce
methods that can sometimes be used to convert a LendingIterator
into an Iterator
- cloned
- copied
- filter_map
- flat_map
- map
- map_while
- scan
methods I'm not sure about
- rev
- rposition