Enum wbuf::InputOutput

pub enum InputOutput {
    Standard(Stdin, Stdout),
    Memory(Cursor<Vec<u8>>),
    File(File),
}

Duplex I/O buffer wrapper type. Wraps stdin/stdout, a read/write Cursor, or a readable/writable file buffer.

Variants

Standard(Stdin, Stdout)

Memory(Cursor<Vec<u8>>)

File(File)

Methods

impl InputOutput

Important traits for InputOutput

impl Read for InputOutputimpl Write for InputOutput

pub fn stdio() -> InputOutput

Returns an InputOutput wrapping stdin and stdout.

Important traits for InputOutput

impl Read for InputOutputimpl Write for InputOutput

pub fn memory() -> InputOutput

Returns an InputOutput wrapping a Cursor.

pub fn file(path: &str) -> Result<InputOutput>

Returns an InputOutput wrapping a readable and writable file.

pub fn from_arg(arg: Option<&str>) -> Result<InputOutput>

Returns either a wrapped file buffer, or stdin, depending on the argument passed in.

The function selects the buffer following these rules:

• No value, or the a literal "-" returns stdin.
• Any other value returns a wrapped file buffer. The file is opened with std::fs::OpenOptions, therefore the file is required to exist, and be readable and writable for the operation to succeed.

Trait Implementations

impl Read for InputOutput

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

Read from the underlying buffer.

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

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

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.

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

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

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

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

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

Read the exact number of bytes required to fill buf.

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

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

fn bytes(self) -> Bytes<Self>

Transforms this Read instance to an [Iterator] over its bytes.

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

Creates an adaptor which will chain this stream with another.

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

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

impl Write for InputOutput

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

Writes into the underlying buffer.

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

Flushes the underlying buffer.

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

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.