Function winnow::binary::u32

source ·
pub fn u32<Input, Error>(endian: Endianness) -> impl Parser<Input, u32, Error>
where Input: StreamIsPartial + Stream<Token = u8>, <Input as Stream>::Slice: AsBytes, Error: ParserError<Input>,
Expand description

Recognizes an unsigned 4 byte integer

If the parameter is winnow::binary::Endianness::Big, parse a big endian u32 integer, otherwise if winnow::binary::Endianness::Little parse a little endian u32 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::u32;

let be_u32 = |s| {
    u32(winnow::binary::Endianness::Big).parse_peek(s)
};

assert_eq!(be_u32(&b"\x00\x03\x05\x07abcefg"[..]), Ok((&b"abcefg"[..], 0x00030507)));
assert_eq!(be_u32(&b"\x01"[..]), Err(ErrMode::Backtrack(InputError::new(&[0x01][..], ErrorKind::Slice))));

let le_u32 = |s| {
    u32(winnow::binary::Endianness::Little).parse_peek(s)
};

assert_eq!(le_u32(&b"\x00\x03\x05\x07abcefg"[..]), Ok((&b"abcefg"[..], 0x07050300)));
assert_eq!(le_u32(&b"\x01"[..]), Err(ErrMode::Backtrack(InputError::new(&[0x01][..], ErrorKind::Slice))));
use winnow::binary::u32;

let be_u32 = |s| {
    u32::<_, InputError<_>>(winnow::binary::Endianness::Big).parse_peek(s)
};

assert_eq!(be_u32(Partial::new(&b"\x00\x03\x05\x07abcefg"[..])), Ok((Partial::new(&b"abcefg"[..]), 0x00030507)));
assert_eq!(be_u32(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(3))));

let le_u32 = |s| {
    u32::<_, InputError<_>>(winnow::binary::Endianness::Little).parse_peek(s)
};

assert_eq!(le_u32(Partial::new(&b"\x00\x03\x05\x07abcefg"[..])), Ok((Partial::new(&b"abcefg"[..]), 0x07050300)));
assert_eq!(le_u32(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(3))));