nom8::character

Function alphanumeric1

Source
pub fn alphanumeric1<T, E: ParseError<T>, const STREAMING: bool>(
    input: T,
) -> IResult<T, <T as IntoOutput>::Output, E>
Expand description

Recognizes one or more ASCII numerical and alphabetic characters: 0-9, a-z, A-Z

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 alphanumerical 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 alphanumerical character).

§Example

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

assert_eq!(parser("21cZ%1"), Ok(("%1", "21cZ")));
assert_eq!(parser("&H2"), Err(Err::Error(Error::new("&H2", ErrorKind::AlphaNumeric))));
assert_eq!(parser(""), Err(Err::Error(Error::new("", ErrorKind::AlphaNumeric))));
assert_eq!(alphanumeric1::<_, (_, ErrorKind), true>(Streaming("21cZ%1")), Ok((Streaming("%1"), "21cZ")));
assert_eq!(alphanumeric1::<_, (_, ErrorKind), true>(Streaming("&H2")), Err(Err::Error((Streaming("&H2"), ErrorKind::AlphaNumeric))));
assert_eq!(alphanumeric1::<_, (_, ErrorKind), true>(Streaming("")), Err(Err::Incomplete(Needed::new(1))));