nom::bytes::streaming

Function take_till

Source
pub fn take_till<F, Input, Error: ParseError<Input>>(
    cond: F,
) -> impl Fn(Input) -> IResult<Input, Input, Error>
where Input: InputTakeAtPosition, F: Fn(<Input as InputTakeAtPosition>::Item) -> bool,
Expand description

Returns the longest input slice (if any) till a predicate is met.

The parser will return the longest slice till the given predicate (a function that takes the input and returns a bool).

§Streaming Specific

Streaming version will return a Err::Incomplete(Needed::new(1)) if the match reaches the end of input or if there was not match.

§Example

use nom::bytes::streaming::take_till;

fn till_colon(s: &str) -> IResult<&str, &str> {
  take_till(|c| c == ':')(s)
}

assert_eq!(till_colon("latin:123"), Ok((":123", "latin")));
assert_eq!(till_colon(":empty matched"), Ok((":empty matched", ""))); //allowed
assert_eq!(till_colon("12345"), Err(Err::Incomplete(Needed::new(1))));
assert_eq!(till_colon(""), Err(Err::Incomplete(Needed::new(1))));