Struct bdrck::logging::write::SyncWriteAdapter

pub struct SyncWriteAdapter<T: Write> { /* fields omitted */ }

This struct is a simple adapter which is composed of a single Write implementor. The idea is that it is guaranteed to implement Send + Sync, as well as Clone, so it allows arbitrary Write implementors to be used with LogOutputFactory.

Note that this does involve a Mutex, so in general there is a performance penalty to using this.

Methods

impl<T: Write + Send + 'static> SyncWriteAdapter<T>

pub fn new(writer: T) -> Self

Create a new SyncWriteAdapter which wraps the given Write implementor.

pub fn lock(&self) -> MutexGuard<T>

Acquire a lock on the internal Write implementor, which allows for e.g. writing output to it without having a mutable reference to this adapter.

Trait Implementations

impl<T: Write + Send + 'static> Clone for SyncWriteAdapter<T>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Write + Send + 'static> Write for SyncWriteAdapter<T>

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

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

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

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

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.