Struct basic_text::TextReader

pub struct TextReader<Inner: ReadStrLayered> { /* fields omitted */ }

A Read implementation which translates from an input Read implementation producing an arbitrary byte sequence into a valid Basic Text stream.

Implementations

impl<Inner: ReadStrLayered> TextReader<Inner>

pub fn new(inner: Inner) -> Self

Construct a new instance of TextReader wrapping inner.

Trait Implementations

impl<Inner: ReadStrLayered + AsRawFd> AsRawFd for TextReader<Inner>

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl<Inner: ReadStrLayered> Bufferable for TextReader<Inner>

fn abandon(&mut self)

Close the resource and abandon any pending buffered contents or errors.

fn suggested_buffer_size(&self) -> usize

A suggested size, in bytes, for buffering for performance.

impl<Inner: ReadStrLayered + Debug> Debug for TextReader<Inner>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<Inner: ReadStrLayered + OwnsRaw> OwnsRaw for TextReader<Inner>

impl<Inner: ReadStrLayered> Read for TextReader<Inner>

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

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize>

Read all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize>

Read all bytes until EOF in this source, appending them to buf.

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

Like read, except that it reads into a slice of buffers.

pub fn is_read_vectored(&self) -> bool

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

Determines if this Reader has an efficient read_vectored implementation.

pub unsafe fn initializer(&self) -> Initializer

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

Determines if this Reader can work with buffers of uninitialized memory.

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

Read the exact number of bytes required to fill buf.

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

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

pub fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an Iterator over its bytes.

pub fn chain<R>(self, next: R) -> Chain<Self, R> where
    R: Read, 

Creates an adaptor which will chain this stream with another.

pub fn take(self, limit: u64) -> Take<Self>

Creates an adaptor which will read at most limit bytes from it.

impl<Inner: ReadStrLayered> ReadLayered for TextReader<Inner>

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

Like Read::read, but also returns a Status.

fn minimum_buffer_size(&self) -> usize

Some streams require a buffer of at least a certain size.

pub fn read_vectored_with_status(
    &mut self,
    bufs: &mut [IoSliceMut<'_>]
) -> Result<(usize, Status), Error>

Like Read::read_vectored, but also returns a Status.

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

Like Read::read_exact, but uses read_with_status to avoid performing an extra read at the end.

impl<Inner: ReadStrLayered> ReadStr for TextReader<Inner>

fn read_str(&mut self, buf: &mut str) -> Result<usize>

Like read but produces the result in a str. Be sure to check the size field of the return value to see how many bytes were written.

fn read_exact_str(&mut self, buf: &mut str) -> Result<()>

Like read_exact but produces the result in a str.

impl<Inner: ReadStrLayered> ReadStrLayered for TextReader<Inner>

fn read_str_with_status(&mut self, buf: &mut str) -> Result<(usize, Status)>

Like read_with_status but produces the result in a str. Be sure to check the return value to see how many bytes were written.

fn read_exact_str_using_status(&mut self, buf: &mut str) -> Result<Status>

Like read_exact but produces the result in a str.

impl<Inner: ReadStrLayered> ReadText for TextReader<Inner>

fn read_text(&mut self, buf: &mut TextStr) -> Result<usize>

Like read but produces the result in a TextStr. Be sure to check the size field of the return value to see how many bytes were written.

fn read_exact_text(&mut self, buf: &mut TextStr) -> Result<()>

Like read_exact but produces the result in a TextStr.

impl<Inner: ReadStrLayered> ReadTextLayered for TextReader<Inner>

fn read_text_with_status(
    &mut self,
    buf: &mut TextStr
) -> Result<(usize, Status)>

Like read_with_status but produces the result in a TextStr. Be sure to check the return value to see how many bytes were written.

fn read_exact_text_using_status(&mut self, buf: &mut TextStr) -> Result<Status>

Like read_exact but produces the result in a TextStr.