Struct zstd::stream::zio::Writer

[+] Show declaration

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

[−] Expand description

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.

Implementations

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.

pub fn operation(&self) -> &D[−]

Gives a reference to the inner operation.

pub fn operation_mut(&mut self) -> &mut D[−]

Gives a mutable reference to the inner operation.

Trait Implementations

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

[+] Show hidden undocumented items

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.

pub fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>[−]

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

pub fn is_write_vectored(&self) -> bool[−]

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

Determines if this Writer has an efficient write_vectored implementation.

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

Attempts to write an entire buffer into this writer.

pub fn write_all_vectored(
    &mut self,
    bufs: &mut [IoSlice<'_>]
) -> Result<(), Error>[−]

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

Attempts to write multiple buffers into this writer.

pub fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<(), Error>[−]

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

pub fn by_ref(&mut self) -> &mut Self[−]

Creates a “by reference” adaptor for this instance of Write.