Function `bits`

fn bits<Input, Output, BitError, ByteError, ParseNext>(parser: ParseNext) -> impl Parser<Input, Output, ByteError>
where
    BitError: ParserError<(Input, usize)> + ErrorConvert<ByteError>,
    ByteError: ParserError<Input>,
    (Input, usize): Stream,
    Input: Stream + Clone,
    ParseNext: Parser<(Input, usize), Output, BitError>

Converts a byte-level input to a bit-level input

See bytes to convert it back.

Example

# use winnow::prelude::*;
# use winnow::Bytes;
# use winnow::binary::bits::{bits, take};
# use winnow::error::ContextError;
# use winnow::error::ErrMode;
type Stream<'i> = &'i Bytes;

fn stream(b: &[u8]) -> Stream<'_> {
    Bytes::new(b)
}

fn parse(input: &mut Stream<'_>) -> ModalResult<(u8, u8)> {
    bits::<_, _, ErrMode<ContextError>, _, _>((take(4usize), take(8usize))).parse_next(input)
}

let input = stream(&[0x12, 0x34, 0xff, 0xff]);

let output = parse.parse_peek(input).expect("We take 1.5 bytes and the input is longer than 2 bytes");

// The first byte is consumed, the second byte is partially consumed and dropped.
let remaining = output.0;
assert_eq!(remaining, stream(&[0xff, 0xff]));

let parsed = output.1;
assert_eq!(parsed.0, 0x01);
assert_eq!(parsed.1, 0x23);