pub struct DeflateEncoder<R> { /* private fields */ }
Expand description
A DEFLATE encoder, or compressor.
This structure implements a Read
interface. When read from, it reads
uncompressed data from the underlying Read
and provides the compressed data.
§Examples
use std::io::prelude::*;
use std::io;
use flate2::Compression;
use flate2::read::DeflateEncoder;
// Return a vector containing the Deflate compressed version of hello world
fn deflateencoder_read_hello_world() -> io::Result<Vec<u8>> {
let mut ret_vec = Vec::new();
let c = b"hello world";
let mut deflater = DeflateEncoder::new(&c[..], Compression::fast());
deflater.read_to_end(&mut ret_vec)?;
Ok(ret_vec)
}
Implementations§
source§impl<R: Read> DeflateEncoder<R>
impl<R: Read> DeflateEncoder<R>
sourcepub fn new(r: R, level: Compression) -> DeflateEncoder<R> ⓘ
pub fn new(r: R, level: Compression) -> DeflateEncoder<R> ⓘ
Creates a new encoder which will read uncompressed data from the given stream and emit the compressed stream.
source§impl<R> DeflateEncoder<R>
impl<R> DeflateEncoder<R>
sourcepub fn reset(&mut self, r: R) -> R
pub fn reset(&mut self, r: R) -> R
Resets the state of this encoder entirely, swapping out the input stream for another.
This function will reset the internal state of this encoder and replace
the input stream with the one provided, returning the previous input
stream. Future data read from this encoder will be the compressed
version of r
’s data.
Note that there may be currently buffered data when this function is called, and in that case the buffered data is discarded.
sourcepub fn get_mut(&mut self) -> &mut R
pub fn get_mut(&mut self) -> &mut R
Acquires a mutable reference to the underlying stream
Note that mutation of the stream may result in surprising results if this encoder is continued to be used.
sourcepub fn into_inner(self) -> R
pub fn into_inner(self) -> R
Consumes this encoder, returning the underlying reader.
Note that there may be buffered bytes which are not re-acquired as part of this transition. It’s recommended to only call this function after EOF has been reached.
Trait Implementations§
source§impl<R: Debug> Debug for DeflateEncoder<R>
impl<R: Debug> Debug for DeflateEncoder<R>
source§impl<R: Read> Read for DeflateEncoder<R>
impl<R: Read> Read for DeflateEncoder<R>
source§fn read(&mut self, buf: &mut [u8]) -> Result<usize>
fn read(&mut self, buf: &mut [u8]) -> Result<usize>
1.36.0 · source§fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>
fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>
read
, except that it reads into a slice of buffers. Read moresource§fn is_read_vectored(&self) -> bool
fn is_read_vectored(&self) -> bool
can_vector
)1.0.0 · source§fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>
fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>
buf
. Read more1.0.0 · source§fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
buf
. Read more1.6.0 · source§fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
buf
. Read moresource§fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>
fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>
read_buf
)source§fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>
fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>
read_buf
)cursor
. Read more1.0.0 · source§fn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
fn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
Read
. Read moresource§impl<W: Read + Write> Write for DeflateEncoder<W>
impl<W: Read + Write> Write for DeflateEncoder<W>
source§fn write(&mut self, buf: &[u8]) -> Result<usize>
fn write(&mut self, buf: &[u8]) -> Result<usize>
source§fn flush(&mut self) -> Result<()>
fn flush(&mut self) -> Result<()>
source§fn is_write_vectored(&self) -> bool
fn is_write_vectored(&self) -> bool
can_vector
)1.0.0 · source§fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
source§fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
write_all_vectored
)