Function u8

pub fn u8<Input, Error>(input: &mut Input) -> Result<u8, Error>
where
    Input: StreamIsPartial + Stream<Token = u8>,
    Error: ParserError<Input>,

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

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

Example

use winnow::binary::u8;

fn parser(s: &mut &[u8]) -> ModalResult<u8> {
      u8.parse_next(s)
}

assert_eq!(parser.parse_peek(&b"\x00\x03abcefg"[..]), Ok((&b"\x03abcefg"[..], 0x00)));
assert!(parser.parse_peek(&b""[..]).is_err());

use winnow::binary::u8;

fn parser(s: &mut Partial<&[u8]>) -> ModalResult<u8> {
      u8.parse_next(s)
}

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