Function nom8::number::u8

source ·
pub fn u8<I, E: ParseError<I>, const STREAMING: bool>(
    input: I
) -> IResult<I, u8, E>where
    I: Slice<RangeFrom<usize>> + InputIter<Item = u8> + InputLength + InputIsStreaming<STREAMING>,
Expand description

Recognizes an unsigned 1 byte integer

Note: that endianness does not apply to 1 byte numbers.

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::u8;

let parser = |s| {
  u8(s)
};

assert_eq!(parser(&b"\x00\x03abcefg"[..]), Ok((&b"\x03abcefg"[..], 0x00)));
assert_eq!(parser(&b""[..]), Err(Err::Error((&[][..], ErrorKind::Eof))));
use nom8::number::u8;

let parser = |s| {
  u8::<_, (_, ErrorKind), true>(s)
};

assert_eq!(parser(Streaming(&b"\x00\x03abcefg"[..])), Ok((Streaming(&b"\x03abcefg"[..]), 0x00)));
assert_eq!(parser(Streaming(&b""[..])), Err(Err::Incomplete(Needed::new(1))));