pub fn u24<I, E: ParseError<I>, const STREAMING: bool>(
endian: Endianness
) -> fn(_: I) -> IResult<I, u32, E>where
I: Slice<RangeFrom<usize>> + InputIter<Item = u8> + InputLength + InputIsStreaming<STREAMING>,
Expand description
Recognizes an unsigned 3 byte integer
If the parameter is nom8::number::Endianness::Big
, parse a big endian u24 integer,
otherwise if nom8::number::Endianness::Little
parse a little endian u24 integer.
Complete version: returns an error if there is not enough input data
Streaming version: Will return Err(nom8::Err::Incomplete(_))
if there is not enough data.
Example
use nom8::number::u24;
let be_u24 = |s| {
u24(nom8::number::Endianness::Big)(s)
};
assert_eq!(be_u24(&b"\x00\x03\x05abcefg"[..]), Ok((&b"abcefg"[..], 0x000305)));
assert_eq!(be_u24(&b"\x01"[..]), Err(Err::Error((&[0x01][..], ErrorKind::Eof))));
let le_u24 = |s| {
u24(nom8::number::Endianness::Little)(s)
};
assert_eq!(le_u24(&b"\x00\x03\x05abcefg"[..]), Ok((&b"abcefg"[..], 0x050300)));
assert_eq!(le_u24(&b"\x01"[..]), Err(Err::Error((&[0x01][..], ErrorKind::Eof))));
use nom8::number::u24;
let be_u24 = |s| {
u24::<_,(_, ErrorKind), true>(nom8::number::Endianness::Big)(s)
};
assert_eq!(be_u24(Streaming(&b"\x00\x03\x05abcefg"[..])), Ok((Streaming(&b"abcefg"[..]), 0x000305)));
assert_eq!(be_u24(Streaming(&b"\x01"[..])), Err(Err::Incomplete(Needed::new(2))));
let le_u24 = |s| {
u24::<_, (_, ErrorKind), true>(nom8::number::Endianness::Little)(s)
};
assert_eq!(le_u24(Streaming(&b"\x00\x03\x05abcefg"[..])), Ok((Streaming(&b"abcefg"[..]), 0x050300)));
assert_eq!(le_u24(Streaming(&b"\x01"[..])), Err(Err::Incomplete(Needed::new(2))));