Function winnow::ascii::hex_digit1
source · pub fn hex_digit1<I, E: ParserError<I>>(
input: &mut I,
) -> PResult<<I as Stream>::Slice, E>
Expand description
Recognizes one or more ASCII hexadecimal numerical characters: '0'..='9'
, 'A'..='F'
,
'a'..='f'
Complete version: Will return an error if there’s not enough input data, or 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_digit1.parse_next(input)
}
assert_eq!(parser.parse_peek("21cZ"), Ok(("Z", "21c")));
assert_eq!(parser.parse_peek("H2"), Err(ErrMode::Backtrack(InputError::new("H2", ErrorKind::Slice))));
assert_eq!(parser.parse_peek(""), Err(ErrMode::Backtrack(InputError::new("", ErrorKind::Slice))));
assert_eq!(hex_digit1::<_, InputError<_>>.parse_peek(Partial::new("21cZ")), Ok((Partial::new("Z"), "21c")));
assert_eq!(hex_digit1::<_, InputError<_>>.parse_peek(Partial::new("H2")), Err(ErrMode::Backtrack(InputError::new(Partial::new("H2"), ErrorKind::Slice))));
assert_eq!(hex_digit1::<_, InputError<_>>.parse_peek(Partial::new("")), Err(ErrMode::Incomplete(Needed::new(1))));