# Function nom::number::complete::u16

source · [−]

    pub fn u16<I, E: ParseError<I>>(
        endian: Endianness
    ) -> fn(_: I) -> IResult<I, u16, E> where
        I: Slice<RangeFrom<usize>> + InputIter<Item = u8> + InputLength,

Expand description

Recognizes an unsigned 2 bytes integer

If the parameter is `nom::number::Endianness::Big`, parse a big endian u16 integer, otherwise if `nom::number::Endianness::Little` parse a little endian u16 integer. complete version: returns an error if there is not enough input data

    use nom::number::complete::u16;

    let be_u16 = |s| {
      u16(nom::number::Endianness::Big)(s)
    };

    assert_eq!(be_u16(&b"\x00\x03abcefg"[..]), Ok((&b"abcefg"[..], 0x0003)));
    assert_eq!(be_u16(&b"\x01"[..]), Err(Err::Error((&[0x01][..], ErrorKind::Eof))));

    let le_u16 = |s| {
      u16(nom::number::Endianness::Little)(s)
    };

    assert_eq!(le_u16(&b"\x00\x03abcefg"[..]), Ok((&b"abcefg"[..], 0x0300)));
    assert_eq!(le_u16(&b"\x01"[..]), Err(Err::Error((&[0x01][..], ErrorKind::Eof))));