Function winnow::ascii::hex_digit0

source ·
pub fn hex_digit0<I, E: ParserError<I>>(
    input: &mut I,
) -> PResult<<I as Stream>::Slice, E>
where I: StreamIsPartial + Stream, <I as Stream>::Token: AsChar,
Expand description

Recognizes zero or more ASCII hexadecimal numerical characters: '0'..='9', 'A'..='F', 'a'..='f'

Complete version: Will return the whole input if no terminating token is found (a non hexadecimal digit character).

Partial version: Will return Err(winnow::error::ErrMode::Incomplete(_)) if there’s not enough input data, or if no terminating token is found (a non hexadecimal digit character).

§Example

fn parser<'s>(input: &mut &'s str) -> PResult<&'s str, InputError<&'s str>> {
    hex_digit0.parse_next(input)
}

assert_eq!(parser.parse_peek("21cZ"), Ok(("Z", "21c")));
assert_eq!(parser.parse_peek("Z21c"), Ok(("Z21c", "")));
assert_eq!(parser.parse_peek(""), Ok(("", "")));
assert_eq!(hex_digit0::<_, InputError<_>>.parse_peek(Partial::new("21cZ")), Ok((Partial::new("Z"), "21c")));
assert_eq!(hex_digit0::<_, InputError<_>>.parse_peek(Partial::new("Z21c")), Ok((Partial::new("Z21c"), "")));
assert_eq!(hex_digit0::<_, InputError<_>>.parse_peek(Partial::new("")), Err(ErrMode::Incomplete(Needed::new(1))));