[−][src]Trait combine::RangeStreamOnce

pub trait RangeStreamOnce: StreamOnce + ResetStream {
    fn uncons_range(
        &mut self, 
        size: usize
    ) -> Result<Self::Range, StreamErrorFor<Self>>;

    fn uncons_while<F>(
        &mut self, 
        f: F
    ) -> Result<Self::Range, StreamErrorFor<Self>>
    where
        F: FnMut(Self::Token) -> bool;

    fn distance(&self, end: &Self::Checkpoint) -> usize;

    fn range(&self) -> Self::Range;

    fn uncons_while1<F>(
        &mut self, 
        f: F
    ) -> ParseResult<Self::Range, StreamErrorFor<Self>>
    where
        F: FnMut(Self::Token) -> bool,
    { ... }
}

A RangeStream is an extension of StreamOnce which allows for zero copy parsing.

Required methods

fn uncons_range(
    &mut self,
    size: usize
) -> Result<Self::Range, StreamErrorFor<Self>>

Takes size elements from the stream. Fails if the length of the stream is less than size.

fn uncons_while<F>(&mut self, f: F) -> Result<Self::Range, StreamErrorFor<Self>> where
    F: FnMut(Self::Token) -> bool, 

Takes items from stream, testing each one with predicate. returns the range of items which passed predicate.

fn distance(&self, end: &Self::Checkpoint) -> usize

Returns the distance between self and end. The returned usize must be so that

ⓘThis example is not tested
let start = stream.checkpoint();
stream.uncons_range(distance);
stream.distance(&start) == distance

fn range(&self) -> Self::Range

Returns the entire range of self

Loading content...

Provided methods

fn uncons_while1<F>(
    &mut self,
    f: F
) -> ParseResult<Self::Range, StreamErrorFor<Self>> where
    F: FnMut(Self::Token) -> bool, 

Takes items from stream, testing each one with predicate returns a range of at least one items which passed predicate.

Note

This may not return PeekOk as it should uncons at least one token.

Loading content...

Implementations on Foreign Types

impl<'a, I: ?Sized> RangeStreamOnce for &'a mut I where
    I: RangeStreamOnce, [src]

impl<'a> RangeStreamOnce for &'a str[src]

impl<'a, T> RangeStreamOnce for &'a [T] where
    T: Clone + PartialEq, [src]

Loading content...

Implementors

impl<'a, T> RangeStreamOnce for SliceStream<'a, T> where
    T: PartialEq + 'a, [src]

impl<Input, X, S> RangeStreamOnce for combine::stream::position::Stream<Input, X> where
    Input: RangeStreamOnce,
    X: RangePositioner<Input::Token, Input::Range>,
    S: StreamError<Input::Token, Input::Range>,
    Input::Error: ParseError<Input::Token, Input::Range, X::Position, StreamError = S>,
    Input::Error: ParseError<Input::Token, Input::Range, Input::Position, StreamError = S>,
    Input::Position: Clone + Ord, [src]

impl<S> RangeStreamOnce for combine::stream::easy::Stream<S> where
    S: RangeStream,
    S::Token: PartialEq,
    S::Range: PartialEq, [src]

impl<S> RangeStreamOnce for CompleteStream<S> where
    S: RangeStreamOnce, [src]

impl<S> RangeStreamOnce for MaybePartialStream<S> where
    S: RangeStreamOnce, [src]

impl<S> RangeStreamOnce for PartialStream<S> where
    S: RangeStreamOnce, [src]

impl<S, U> RangeStreamOnce for combine::stream::state::Stream<S, U> where
    S: RangeStreamOnce, [src]

Loading content...