Function nom::multi::many1

source ·
pub fn many1<I, O, E, F>(f: F) -> impl FnMut(I) -> IResult<I, Vec<O>, E>
where I: Clone + InputLength, F: Parser<I, O, E>, E: ParseError<I>,
Expand description

Runs the embedded parser, gathering the results in a Vec.

This stops on Err::Error if there is at least one result, and returns the results that were accumulated. To instead chain an error up, see cut.

§Arguments

  • f The parser to apply.

Note: If the parser passed to many1 accepts empty inputs (like alpha0 or digit0), many1 will return an error, to prevent going into an infinite loop.

use nom::multi::many1;
use nom::bytes::complete::tag;

fn parser(s: &str) -> IResult<&str, Vec<&str>> {
  many1(tag("abc"))(s)
}

assert_eq!(parser("abcabc"), Ok(("", vec!["abc", "abc"])));
assert_eq!(parser("abc123"), Ok(("123", vec!["abc"])));
assert_eq!(parser("123123"), Err(Err::Error(Error::new("123123", ErrorKind::Tag))));
assert_eq!(parser(""), Err(Err::Error(Error::new("", ErrorKind::Tag))));