Function winnow::ascii::alphanumeric1

source ·
pub fn alphanumeric1<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 one or more ASCII numerical and alphabetic characters: 'a'..='z', 'A'..='Z', '0'..='9'

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

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

§Example

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

assert_eq!(parser.parse_peek("21cZ%1"), Ok(("%1", "21cZ")));
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!(alphanumeric1::<_, InputError<_>>.parse_peek(Partial::new("21cZ%1")), Ok((Partial::new("%1"), "21cZ")));
assert_eq!(alphanumeric1::<_, InputError<_>>.parse_peek(Partial::new("&H2")), Err(ErrMode::Backtrack(InputError::new(Partial::new("&H2"), ErrorKind::Slice))));
assert_eq!(alphanumeric1::<_, InputError<_>>.parse_peek(Partial::new("")), Err(ErrMode::Incomplete(Needed::new(1))));