tendril::stream

Trait TendrilSink

Source
pub trait TendrilSink<F, A = NonAtomic>
where F: Format, A: Atomicity,
{ type Output; // Required methods fn process(&mut self, t: Tendril<F, A>); fn error(&mut self, desc: Cow<'static, str>); fn finish(self) -> Self::Output; // Provided methods fn one<T>(self, t: T) -> Self::Output where Self: Sized, T: Into<Tendril<F, A>> { ... } fn from_iter<I>(self, i: I) -> Self::Output where Self: Sized, I: IntoIterator, I::Item: Into<Tendril<F, A>> { ... } fn read_from<R>(self, r: &mut R) -> Result<Self::Output> where Self: Sized, R: Read, F: SliceFormat<Slice = [u8]> { ... } fn from_file<P>(self, path: P) -> Result<Self::Output> where Self: Sized, P: AsRef<Path>, F: SliceFormat<Slice = [u8]> { ... } }
Expand description

Trait for types that can process a tendril.

This is a “push” interface, unlike the “pull” interface of Iterator<Item=Tendril<F>>. The push interface matches html5ever and other incremental parsers with a similar architecture.

Required Associated Types§

Source

type Output

What the overall result of processing is.

Required Methods§

Source

fn process(&mut self, t: Tendril<F, A>)

Process this tendril.

Source

fn error(&mut self, desc: Cow<'static, str>)

Indicates that an error has occurred.

Source

fn finish(self) -> Self::Output

Indicates the end of the stream.

Provided Methods§

Source

fn one<T>(self, t: T) -> Self::Output
where Self: Sized, T: Into<Tendril<F, A>>,

Process one tendril and finish.

Source

fn from_iter<I>(self, i: I) -> Self::Output
where Self: Sized, I: IntoIterator, I::Item: Into<Tendril<F, A>>,

Consume an iterator of tendrils, processing each item, then finish.

Source

fn read_from<R>(self, r: &mut R) -> Result<Self::Output>
where Self: Sized, R: Read, F: SliceFormat<Slice = [u8]>,

Read from the given stream of bytes until exhaustion and process incrementally, then finish. Return Err at the first I/O error.

Source

fn from_file<P>(self, path: P) -> Result<Self::Output>
where Self: Sized, P: AsRef<Path>, F: SliceFormat<Slice = [u8]>,

Read from the file at the given path and process incrementally, then finish. Return Err at the first I/O error.

Implementors§

Source§

impl<Sink, A> TendrilSink<Bytes, A> for Utf8LossyDecoder<Sink, A>
where Sink: TendrilSink<UTF8, A>, A: Atomicity,

Source§

type Output = <Sink as TendrilSink<UTF8, A>>::Output