Function binrw::helpers::until_with

pub fn until_with<Reader, T, CondFn, Arg, ReadFn, Ret>(
    cond: CondFn,
    read: ReadFn,
) -> impl Fn(&mut Reader, Endian, Arg) -> BinResult<Ret>
where
    Reader: Read + Seek,
    CondFn: Fn(&T) -> bool,
    Arg: Clone,
    ReadFn: Fn(&mut Reader, Endian, Arg) -> BinResult<T>,
    Ret: FromIterator<T>,

Creates a parser that uses a given function to read items into a collection until a condition is met. The terminal item is added to the collection.

The given read function should return one item each time it is called.

This helper can be used to read into any collection type that implements FromIterator.

Examples

Reading a two-dimensional VecDeque by combining until_with and count:

#[derive(BinRead)]
struct NullTerminated {
    #[br(parse_with = until_with(|bytes| bytes == &[0, 0], count(2)))]
    data: VecDeque<VecDeque<u8>>,
}