Struct StderrOverride

pub struct StderrOverride { /* private fields */ }

An overridden standard error.

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

Implementations

impl StderrOverride

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

Redirect standard error 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 error.

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

Redirect standard error 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 error to the IO device. The device must be writable.

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

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

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

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

Redirect the standard error 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 error 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 StderrOverride

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for StderrOverride

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

Formats the value using the given formatter.

impl Drop for StderrOverride

fn drop(&mut self)

Executes the destructor for this type.

impl Write for &StderrOverride

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 StderrOverride

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.