Struct tendril::stream::Utf8LossyDecoder

pub struct Utf8LossyDecoder<Sink, A = NonAtomic> where
    Sink: TendrilSink<UTF8, A>,
    A: Atomicity,  {
    pub inner_sink: Sink,
    // some fields omitted
}

A TendrilSink adaptor that takes bytes, decodes them as UTF-8, lossily replace ill-formed byte sequences with U+FFFD replacement characters, and emits Unicode (StrTendril).

This does not allocate memory: the output is either subtendrils on the input, on inline tendrils for a single code point.

Fields

inner_sink: Sink

Methods

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

pub fn new(inner_sink: Sink) -> Self

Create a new incremental UTF-8 decoder.

Trait Implementations

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

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

Process this tendril.

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

Indicates that an error has occurred.

type Output = Sink::Output

What the overall result of processing is.

fn finish(self) -> Sink::Output

Indicates the end of the stream.

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

Process one tendril and finish.

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.

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.

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.