winnow::ascii

Function alphanumeric0

Source
pub fn alphanumeric0<Input, Error>(
    input: &mut Input,
) -> PResult<<Input as Stream>::Slice, Error>
where Input: StreamIsPartial + Stream, <Input as Stream>::Token: AsChar, Error: ParserError<Input>,
Expand description

Recognizes zero or more ASCII numerical and alphabetic characters: 'a'..='z', 'A'..='Z', '0'..='9'

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

[Partial version][crate::_topic::partial]: 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).

§Effective Signature

Assuming you are parsing a &str Stream:

pub fn alphanumeric0<'i>(input: &mut &'i str) -> PResult<&'i str>

§Example

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

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