pub fn u32<Input, Error>(endian: Endianness) -> impl Parser<Input, u32, Error>
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;
fn be_u32(input: &mut &[u8]) -> ModalResult<u32> {
u32(winnow::binary::Endianness::Big).parse_next(input)
};
assert_eq!(be_u32.parse_peek(&b"\x00\x03\x05\x07abcefg"[..]), Ok((&b"abcefg"[..], 0x00030507)));
assert!(be_u32.parse_peek(&b"\x01"[..]).is_err());
fn le_u32(input: &mut &[u8]) -> ModalResult<u32> {
u32(winnow::binary::Endianness::Little).parse_next(input)
};
assert_eq!(le_u32.parse_peek(&b"\x00\x03\x05\x07abcefg"[..]), Ok((&b"abcefg"[..], 0x07050300)));
assert!(le_u32.parse_peek(&b"\x01"[..]).is_err());
use winnow::binary::u32;
fn be_u32(input: &mut Partial<&[u8]>) -> ModalResult<u32> {
u32(winnow::binary::Endianness::Big).parse_next(input)
};
assert_eq!(be_u32.parse_peek(Partial::new(&b"\x00\x03\x05\x07abcefg"[..])), Ok((Partial::new(&b"abcefg"[..]), 0x00030507)));
assert_eq!(be_u32.parse_peek(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(3))));
fn le_u32(input: &mut Partial<&[u8]>) -> ModalResult<u32> {
u32(winnow::binary::Endianness::Little).parse_next(input)
};
assert_eq!(le_u32.parse_peek(Partial::new(&b"\x00\x03\x05\x07abcefg"[..])), Ok((Partial::new(&b"abcefg"[..]), 0x07050300)));
assert_eq!(le_u32.parse_peek(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(3))));