Function winnow::binary::i8

source ·
pub fn i8<I, E: ParserError<I>>(input: &mut I) -> PResult<i8, E>
where I: StreamIsPartial + Stream<Token = u8>,
Expand description

Recognizes a signed 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: Will return Err(winnow::error::ErrMode::Incomplete(_)) if there is not enough data.

§Example

use winnow::binary::i8;

fn parser(s: &[u8]) -> IResult<&[u8], i8> {
      i8.parse_peek(s)
}

assert_eq!(parser(&b"\x00\x03abcefg"[..]), Ok((&b"\x03abcefg"[..], 0x00)));
assert_eq!(parser(&b""[..]), Err(ErrMode::Backtrack(InputError::new(&[][..], ErrorKind::Token))));
use winnow::binary::i8;

fn parser(s: Partial<&[u8]>) -> IResult<Partial<&[u8]>, i8> {
      i8.parse_peek(s)
}

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