Struct CowIter

pub struct CowIter<'a> { /* private fields */ }

COW (copy-on-write) AUX area iterator.

Same as COW record iterator, but for AUX area.

Implementations

impl<'a> CowIter<'a>

pub fn next<F, R>( &mut self, f: F, max_chunk_len: Option<NonZeroUsize>, ) -> Option<R>

where F: FnOnce(CowChunk<'_>) -> R,

Advances the iterator and returns the next value.

max_chunk_len specifies the maximum length of a chunk that can be produced at one time, unlimited if None.

If AUX area tracing is in happening, operations in the closure should be quick and cheap. Slow iteration of raw bytes may throttle kernel threads from outputting new data to the AUX area, and heavyd operations may affect the performance of the target process.

pub fn into_async(self) -> Result<AsyncCowIter<'a>>

Creates an asynchronous iterator.