Function u64

pub fn u64<Input, Error>(endian: Endianness) -> impl Parser<Input, u64, Error>
where
    Input: StreamIsPartial + Stream<Token = u8>,
    Error: ParserError<Input>,

Recognizes an unsigned 8 byte integer

If the parameter is winnow::binary::Endianness::Big, parse a big endian u64 integer, otherwise if winnow::binary::Endianness::Little parse a little endian u64 integer.

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

fn be_u64(input: &mut &[u8]) -> ModalResult<u64> {
    u64(winnow::binary::Endianness::Big).parse_next(input)
};

assert_eq!(be_u64.parse_peek(&b"\x00\x01\x02\x03\x04\x05\x06\x07abcefg"[..]), Ok((&b"abcefg"[..], 0x0001020304050607)));
assert!(be_u64.parse_peek(&b"\x01"[..]).is_err());

fn le_u64(input: &mut &[u8]) -> ModalResult<u64> {
    u64(winnow::binary::Endianness::Little).parse_next(input)
};

assert_eq!(le_u64.parse_peek(&b"\x00\x01\x02\x03\x04\x05\x06\x07abcefg"[..]), Ok((&b"abcefg"[..], 0x0706050403020100)));
assert!(le_u64.parse_peek(&b"\x01"[..]).is_err());

use winnow::binary::u64;

fn be_u64(input: &mut Partial<&[u8]>) -> ModalResult<u64> {
    u64(winnow::binary::Endianness::Big).parse_next(input)
};

assert_eq!(be_u64.parse_peek(Partial::new(&b"\x00\x01\x02\x03\x04\x05\x06\x07abcefg"[..])), Ok((Partial::new(&b"abcefg"[..]), 0x0001020304050607)));
assert_eq!(be_u64.parse_peek(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(7))));

fn le_u64(input: &mut Partial<&[u8]>) -> ModalResult<u64> {
    u64(winnow::binary::Endianness::Little).parse_next(input)
};

assert_eq!(le_u64.parse_peek(Partial::new(&b"\x00\x01\x02\x03\x04\x05\x06\x07abcefg"[..])), Ok((Partial::new(&b"abcefg"[..]), 0x0706050403020100)));
assert_eq!(le_u64.parse_peek(Partial::new(&b"\x01"[..])), Err(ErrMode::Incomplete(Needed::new(7))));