Function winnow::character::alpha1

source ·
pub fn alpha1<I, E: ParseError<I>>(
    input: I
) -> IResult<I, <I as Stream>::Slice, E>where
    I: StreamIsPartial + Stream,
    <I as Stream>::Token: AsChar,
Expand description

Recognizes one or more lowercase and uppercase ASCII alphabetic characters: 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 alphabetic 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 alphabetic character).

Example

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

assert_eq!(parser("aB1c"), Ok(("1c", "aB")));
assert_eq!(parser("1c"), Err(ErrMode::Backtrack(Error::new("1c", ErrorKind::Alpha))));
assert_eq!(parser(""), Err(ErrMode::Backtrack(Error::new("", ErrorKind::Alpha))));
assert_eq!(alpha1::<_, Error<_>>(Partial::new("aB1c")), Ok((Partial::new("1c"), "aB")));
assert_eq!(alpha1::<_, Error<_>>(Partial::new("1c")), Err(ErrMode::Backtrack(Error::new(Partial::new("1c"), ErrorKind::Alpha))));
assert_eq!(alpha1::<_, Error<_>>(Partial::new("")), Err(ErrMode::Incomplete(Needed::new(1))));