Trait InputTakeAtPosition

pub trait InputTakeAtPosition: Sized {
    type Item;

    // Required methods
    fn split_at_position<P, E>(
        &self,
        predicate: P,
    ) -> Result<(Self, Self), Err<E>>
       where E: ParseError<Self>,
             P: Fn(Self::Item) -> bool;
    fn split_at_position1<P, E>(
        &self,
        predicate: P,
        e: ErrorKind,
    ) -> Result<(Self, Self), Err<E>>
       where E: ParseError<Self>,
             P: Fn(Self::Item) -> bool;
    fn split_at_position_complete<P, E>(
        &self,
        predicate: P,
    ) -> Result<(Self, Self), Err<E>>
       where E: ParseError<Self>,
             P: Fn(Self::Item) -> bool;
    fn split_at_position1_complete<P, E>(
        &self,
        predicate: P,
        e: ErrorKind,
    ) -> Result<(Self, Self), Err<E>>
       where E: ParseError<Self>,
             P: Fn(Self::Item) -> bool;
}
Expand description

Methods to take as much input as possible until the provided function returns true for the current element.

A large part of nom’s basic parsers are built using this trait.

Required Associated Types§

type Item

The current input type is a sequence of that Item type.

Example: u8 for &[u8] or char for &str

Required Methods§

fn split_at_position<P, E>(&self, predicate: P) -> Result<(Self, Self), Err<E>>
where E: ParseError<Self>, P: Fn(Self::Item) -> bool,

Looks for the first element of the input type for which the condition returns true, and returns the input up to this position.

streaming version: If no element is found matching the condition, this will return Incomplete

fn split_at_position1<P, E>( &self, predicate: P, e: ErrorKind, ) -> Result<(Self, Self), Err<E>>
where E: ParseError<Self>, P: Fn(Self::Item) -> bool,

Looks for the first element of the input type for which the condition returns true and returns the input up to this position.

Fails if the produced slice is empty.

streaming version: If no element is found matching the condition, this will return Incomplete

fn split_at_position_complete<P, E>( &self, predicate: P, ) -> Result<(Self, Self), Err<E>>
where E: ParseError<Self>, P: Fn(Self::Item) -> bool,

Looks for the first element of the input type for which the condition returns true, and returns the input up to this position.

complete version: If no element is found matching the condition, this will return the whole input

fn split_at_position1_complete<P, E>( &self, predicate: P, e: ErrorKind, ) -> Result<(Self, Self), Err<E>>
where E: ParseError<Self>, P: Fn(Self::Item) -> bool,

Looks for the first element of the input type for which the condition returns true and returns the input up to this position.

Fails if the produced slice is empty.

complete version: If no element is found matching the condition, this will return the whole input

Dyn Compatibility§

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types§

§

impl<'a> InputTakeAtPosition for &'a str

§

type Item = char

§

fn split_at_position<P, E>( &self, predicate: P, ) -> Result<(&'a str, &'a str), Err<E>>
where E: ParseError<&'a str>, P: Fn(<&'a str as InputTakeAtPosition>::Item) -> bool,

§

fn split_at_position1<P, E>( &self, predicate: P, e: ErrorKind, ) -> Result<(&'a str, &'a str), Err<E>>
where E: ParseError<&'a str>, P: Fn(<&'a str as InputTakeAtPosition>::Item) -> bool,

§

fn split_at_position_complete<P, E>( &self, predicate: P, ) -> Result<(&'a str, &'a str), Err<E>>
where E: ParseError<&'a str>, P: Fn(<&'a str as InputTakeAtPosition>::Item) -> bool,

§

fn split_at_position1_complete<P, E>( &self, predicate: P, e: ErrorKind, ) -> Result<(&'a str, &'a str), Err<E>>
where E: ParseError<&'a str>, P: Fn(<&'a str as InputTakeAtPosition>::Item) -> bool,

§

impl<'a> InputTakeAtPosition for &'a [u8]

§

type Item = u8

§

fn split_at_position<P, E>( &self, predicate: P, ) -> Result<(&'a [u8], &'a [u8]), Err<E>>
where E: ParseError<&'a [u8]>, P: Fn(<&'a [u8] as InputTakeAtPosition>::Item) -> bool,

§

fn split_at_position1<P, E>( &self, predicate: P, e: ErrorKind, ) -> Result<(&'a [u8], &'a [u8]), Err<E>>
where E: ParseError<&'a [u8]>, P: Fn(<&'a [u8] as InputTakeAtPosition>::Item) -> bool,

§

fn split_at_position_complete<P, E>( &self, predicate: P, ) -> Result<(&'a [u8], &'a [u8]), Err<E>>
where E: ParseError<&'a [u8]>, P: Fn(<&'a [u8] as InputTakeAtPosition>::Item) -> bool,

§

fn split_at_position1_complete<P, E>( &self, predicate: P, e: ErrorKind, ) -> Result<(&'a [u8], &'a [u8]), Err<E>>
where E: ParseError<&'a [u8]>, P: Fn(<&'a [u8] as InputTakeAtPosition>::Item) -> bool,

Implementors§