Struct StdoutOverride

pub struct StdoutOverride { /* private fields */ }

An overridden standard output.

Writing to this writes to the original standard output. When it is dropped the standard output will be reset.

Implementations

impl StdoutOverride

pub fn from_raw(raw: RawFd) -> Result<Self>

Redirect standard output to the raw file descriptor or handle. It must be writable.

The stream is not owned, so it is your job to close it later. Closing it while this exists will not close the standard output.

pub fn from_raw_owned(raw: RawFd) -> Result<Self>

Redirect standard output to the owned raw file descriptor or handle. It must be writable.

The stream is owned, and so you must not use it after passing it to this function.

pub fn from_io_ref<T: AsRaw>(io: &T) -> Result<Self>

Redirect standard output to the IO device. The device must be writable.

Dropping the IO device after calling this function will not close the standard output.

pub fn from_io<T: IntoRaw>(io: T) -> Result<Self>

Redirect standard output to the IO device. The device must be writable.

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self>

Redirect the standard output to the file at that file path.

The file will be created if it does not exist, and will be truncated if it does.

pub fn reset(self) -> Result<()>

Reset the standard output to its state before this type was constructed.

This can be called to manually handle errors produced by the destructor.

Trait Implementations

impl AsRawFd for StdoutOverride

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for StdoutOverride

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

Formats the value using the given formatter.

impl Drop for StdoutOverride

fn drop(&mut self)

Executes the destructor for this type.

impl Write for &StdoutOverride

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

Writes a buffer into this writer, returning how many bytes were written.

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

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

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

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

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.

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

Attempts to write an entire buffer into this writer.

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.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

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

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

where Self: Sized,

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

impl Write for StdoutOverride

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

Writes a buffer into this writer, returning how many bytes were written.

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

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

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

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

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.

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

Attempts to write an entire buffer into this writer.

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.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

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

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

where Self: Sized,

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