Struct termcolor::BufferWriter

pub struct BufferWriter {
    pub(crate) stream: LossyStandardStream<IoStandardStream>,
    pub(crate) printed: AtomicBool,
    pub(crate) separator: Option<Vec<u8>>,
    pub(crate) color_choice: ColorChoice,
}

Writes colored buffers to stdout or stderr.

Writable buffers can be obtained by calling buffer on a BufferWriter.

This writer works with terminals that support ANSI escape sequences or with a Windows console.

It is intended for a BufferWriter to be put in an Arc and written to from multiple threads simultaneously.

Fields

stream: LossyStandardStream<IoStandardStream>

printed: AtomicBool

separator: Option<Vec<u8>>

color_choice: ColorChoice

Implementations

impl BufferWriter

pub(crate) fn create( sty: StandardStreamType, choice: ColorChoice, ) -> BufferWriter

Create a new BufferWriter that writes to a standard stream with the given color preferences.

The specific color/style settings can be configured when writing to the buffers themselves.

pub fn stdout(choice: ColorChoice) -> BufferWriter

Create a new BufferWriter that writes to stdout with the given color preferences.

On Windows, if coloring is desired and a Windows console could not be found, then ANSI escape sequences are used instead.

The specific color/style settings can be configured when writing to the buffers themselves.

pub fn stderr(choice: ColorChoice) -> BufferWriter

Create a new BufferWriter that writes to stderr with the given color preferences.

On Windows, if coloring is desired and a Windows console could not be found, then ANSI escape sequences are used instead.

The specific color/style settings can be configured when writing to the buffers themselves.

pub fn separator(&mut self, sep: Option<Vec<u8>>)

If set, the separator given is printed between buffers. By default, no separator is printed.

The default value is None.

pub fn buffer(&self) -> Buffer

Creates a new Buffer with the current color preferences.

A Buffer satisfies both io::Write and WriteColor. A Buffer can be printed using the print method.

pub fn print(&self, buf: &Buffer) -> Result<()>

Prints the contents of the given buffer.

It is safe to call this from multiple threads simultaneously. In particular, all buffers are written atomically. No interleaving will occur.

Trait Implementations

impl Debug for BufferWriter

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

Formats the value using the given formatter.