#include <evo/iothread.h>

Detailed Description

Multithreaded console I/O.

This wraps existing Console streams with synchronization to support use by multiple threads
Each stream operation must use the EVO_IO_MT() macro (or equivalent) in order to be thread-safe
Call ConsoleMT::get() or con_mt() (shortcut) to get a console reference, or use EVO_CONSOLE_MT (shortcut macro)
Compiler: ConsoleMT::get() and con_mt() aren't thread safe without compiler support for "magic statics", which requires at least:
- Microsoft Visual C++ 2015
- gcc 4.3, clang 2.9
See also: ConsoleNotMT

Example

#include <evo/iothread.h>
using namespace evo;
static ConsoleMT& c = con_mt();
int main() {
    // Thread safe console output
    EVO_IO_MT(c.out, << "Hello World " << 123 << NL)
    // Thread safe console output without macro
    { Mutex::Lock lock(c.out.mutex); c.out.stream << "Hello World " << 123 << NL; }
}

Public Types
typedef PipeOut::Format	Format
	Stream output formatter with state. More...

typedef StreamExtMT< PipeIn, Mutex >	InT
	Input type. More...

typedef Mutex::Lock	Lock
	Mutex lock type. More...

typedef StreamExtMT< PipeOut, Mutex >	OutT
	Output type. More...

Static Public Member Functions
static ConsoleMT &	get ()
	Get console instance to use. More...

Public Attributes
OutT	err
	Write to console, error output. More...

InT	in
	Read console input. More...

OutT	out
	Write to console, normal output. More...

Member Typedef Documentation

◆ Format

typedef PipeOut::Format Format

Stream output formatter with state.

This is associated with a Stream object and supports stateful (i.e. sticky) output formatting with "<<" operator on this object
- Use Stream::Format (where Stream is the stream type used)
Formatting attributes include:
- Aligned fields for formatting text "columns"
- Integer base, prefix, and padding (in addition to field padding)
- Floating point precision and padding (in additon to field padding)
- String to use for "null" values (null char*, String, Int, etc)
Note: Single character (char) and Newline (NL) values are not formatted as fields (i.e. not padded) since they're usually delimiters
See: Stream Formatting

Examples

Example using File:

#include <evo/io.h>
using namespace evo;
int main() {
    File file("file.txt", oWRITE_NEW);
    // Use a temporary formatter to write line: 7B,1C8
    File::Format(file) << fHEX << 123 << ',' << 456 << NL;
    // Create a formatter and use to write line: 001,002
    File::Format out(file);
    out << FmtSetInt(fDEC, 3) << 1 << ',' << 2 << NL;
    return 0;
}

Example using Console (stdout):

#include <evo/io.h>
using namespace evo;
int main() {
    Console& c = con();
    // Use a temporary formatter to write line: 7B,1C8
    Console::Format(c.out) << fHEX << 123 << ',' << 456 << NL;
    // Create a formatter and use to write line: 001,002
    Console::Format out(c.out);
    out << FmtSetInt(fDEC, 3) << 1 << ',' << 2 << NL;
    return 0;
}