winnow::binary

Function le_i24

Source
pub fn le_i24<Input, Error>(input: &mut Input) -> PResult<i32, Error>
where Input: StreamIsPartial + Stream<Token = u8>, Error: ParserError<Input>,
Expand description

Recognizes a little endian signed 3 bytes integer.

Complete version: Returns an error if there is not enough input data.

[Partial version][crate::_topic::partial]: Will return Err(winnow::error::ErrMode::Incomplete(_)) if there is not enough data.

ยงExample

use winnow::binary::le_i24;

fn parser(s: &[u8]) -> IResult<&[u8], i32> {
      le_i24.parse_peek(s)
}

assert_eq!(parser(&b"\x00\x03\x05abcefg"[..]), Ok((&b"abcefg"[..], 0x050300)));
assert_eq!(parser(&b"\x01"[..]), Err(ErrMode::Backtrack(InputError::new(&[0x01][..], ErrorKind::Slice))));
use winnow::binary::le_i24;

fn parser(s: Partial<&[u8]>) -> IResult<Partial<&[u8]>, i32> {
      le_i24::<_, InputError<_>>.parse_peek(s)
}

assert_eq!(parser(Partial::new(&b"\x00\x01\x02abcd"[..])), Ok((Partial::new(&b"abcd"[..]), 0x020100)));
assert_eq!(parser(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(2))));