Enum wbuf::Input

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

Input buffer wrapper type. Wraps stdin, a read-only memory Cursor, or a readable file buffer.

Variants

Standard(Stdin)

Memory(Cursor<Vec<u8>>)

File(File)

Methods

impl Input

pub fn stdin() -> Self

Returns an Input wrapping stdin.

pub fn memory() -> Self

Returns an Input wrapping a Cursor.

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

Returns an Input wrapping a file.

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

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 for the operation to succeed.

Trait Implementations

impl Read for Input

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

Reads 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.