Function winnow::binary::be_u16

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

Recognizes a big endian unsigned 2 bytes integer.

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

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

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

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

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