Struct zstd::stream::zio::Writer

pub struct Writer<W, D> { /* fields omitted */ }

Implements the Write API around an Operation.

This can be used to wrap a raw in-memory operation in a write-focused API.

It can be used with either compression or decompression, and forwards the output to a wrapped Write.

Methods

impl<W, D> Writer<W, D> where
    W: Write,
    D: Operation, 

pub fn new(writer: W, operation: D) -> Self

Creates a new Writer.

All output from the given operation will be forwarded to writer.

pub fn finish(&mut self) -> Result<()>

Ends the stream.

This must be called after all data has been written to finish the stream.

If you forget to call this and just drop the Writer, you will have an incomplete output.

Keep calling it until it returns Ok(()), then don't call it again.

pub fn into_inner(self) -> (W, D)

Return the wrapped Writer and Operation.

Careful: if you call this before calling Writer::finish(), the output may be incomplete.

pub fn writer(&self) -> &W

Gives a reference to the inner writer.

pub fn writer_mut(&mut self) -> &mut W

Gives a mutable reference to the inner writer.

Trait Implementations

impl<W, D> Write for Writer<W, D> where
    W: Write,
    D: Operation, 

fn write(&mut self, buf: &[u8]) -> Result<usize>

Write a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> Result<()>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoVec]) -> Result<usize, Error>

🔬 This is a nightly-only experimental API. (iovec)

Like write, except that it writes from a slice of buffers.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_fmt(&mut self, fmt: Arguments) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

Creates a "by reference" adaptor for this instance of Write.