Function nom8::character::hex_digit1

source ·
pub fn hex_digit1<T, E: ParseError<T>, const STREAMING: bool>(
    input: T
) -> IResult<T, <T as IntoOutput>::Output, E>where
    T: InputTakeAtPosition + InputIsStreaming<STREAMING> + IntoOutput,
    <T as InputTakeAtPosition>::Item: AsChar,
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).

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

Example

fn parser(input: &str) -> IResult<&str, &str> {
    hex_digit1(input)
}

assert_eq!(parser("21cZ"), Ok(("Z", "21c")));
assert_eq!(parser("H2"), Err(Err::Error(Error::new("H2", ErrorKind::HexDigit))));
assert_eq!(parser(""), Err(Err::Error(Error::new("", ErrorKind::HexDigit))));
assert_eq!(hex_digit1::<_, (_, ErrorKind), true>(Streaming("21cZ")), Ok((Streaming("Z"), "21c")));
assert_eq!(hex_digit1::<_, (_, ErrorKind), true>(Streaming("H2")), Err(Err::Error((Streaming("H2"), ErrorKind::HexDigit))));
assert_eq!(hex_digit1::<_, (_, ErrorKind), true>(Streaming("")), Err(Err::Incomplete(Needed::new(1))));