StreamFormatter< T > Struct Template Reference

#include <evo/iobase.h>

Detailed Description

template<class T>
struct evo::StreamFormatter< T >

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;
}

For more examples see: Stream Formatting

Public Types
typedef T	Out
	Associated output stream type, type returned by write_out() More...
typedef T::Size	Size
	Data size type (ulong) More...
typedef StreamFormatter< T >	This
	This type. More...

Public Member Functions
	StreamFormatter (Out &out)
	Constructor. More...
	StreamFormatter (const This &src)
	Copy constructor. More...
This &	operator<< (FmtAlign align)
	Set field alignment type to use. More...
This &	operator<< (FmtWidth width)
	Set field width to use. More...
This &	operator<< (const FmtSetField &field)
	Set field attributes to use. More...
This &	operator<< (Newline nl)
	Write an explicit newline and flush stream. More...
This &	operator<< (NewlineDefault nl)
	Write default newline and flush stream. More...
This &	operator<< (const NewlineValue &nl)
	Write newline value and flush stream. More...
This &	operator<< (Flush)
	Flush buffer by writing to stream. More...
This &	operator<< (const FmtSetNull &null)
	Set attributes for null values. More...
This &	operator<< (bool val)
	Append a bool value. More...
This &	operator<< (char ch)
	Append a character. More...
This &	operator<< (const FmtChar &ch)
	Append a repeated character. More...
This &	operator<< (const FmtString &str)
	Append a formatted string. More...
This &	operator<< (const char *val)
	Append a terminated string. More...
template<class TSize >
This &	operator<< (const ListBase< char, TSize > &str)
	Append a string. More...
This &	operator<< (FmtBase base)
	Set base for formatting integers. More...
This &	operator<< (FmtBasePrefix prefix)
	Set prefix for formatting integers. More...
This &	operator<< (const FmtSetInt &fmt_int)
	Set integer formatting attributes. More...
This &	operator<< (short num)
	Append a formatted signed integer. More...
This &	operator<< (int num)
	Append a formatted signed integer. More...
This &	operator<< (long num)
	Append a formatted signed integer. More...
This &	operator<< (longl num)
	Append a formatted signed integer. More...
This &	operator<< (ushort num)
	Append a formatted unsigned integer. More...
This &	operator<< (uint num)
	Append a formatted unsigned integer. More...
This &	operator<< (ulong num)
	Append a formatted unsigned integer. More...
This &	operator<< (ulongl num)
	Append a formatted unsigned integer. More...
template<class U >
This &	operator<< (const IntegerT< U > &num)
	Append a formatted integer class. More...
This &	operator<< (FmtPrecision prec)
	Set floating point formatting precision. More...
This &	operator<< (const FmtSetFloat &fmt_flt)
	Set floating point formatting attributes. More...
This &	operator<< (float num)
	Append a formatting floating point number. More...
This &	operator<< (double num)
	Append a formatting floating point number. More...
This &	operator<< (ldouble num)
	Append a formatting floating point number. More...
template<class U >
This &	operator<< (const FloatT< U > &num)
	Append a formatted integer class. More...
This &	operator<< (const FmtPtr &fmtptr)
	Writer formatted pointer field to stream. More...
This &	operator<< (const FmtDump &fmtdump)
	Write formatted data dump to stream. More...
This &	operator= (const This &src)
	Assignment operator copies attributes. More...
Out &	write_out ()
	Get parent output string. More...

Public Attributes
FmtAttribs	fmt
	Formatting attributes (state) More...
Out &	out
	Associated output stream. More...

Member Typedef Documentation

Out

typedef T Out

Associated output stream type, type returned by write_out()

Size

typedef T::Size Size

Data size type (ulong)

This

typedef StreamFormatter<T> This

This type.

Constructor & Destructor Documentation

StreamFormatter() [1/2]

StreamFormatter ( Out &  out )

inline

Constructor.

Parameters

out	Output stream to associate and format to

StreamFormatter() [2/2]

StreamFormatter ( const This &  src )

inline

Copy constructor.

• This will reference the same stream as src

Parameters

src	Source to copy

Member Function Documentation

operator<<() [1/34]

This& operator<< ( FmtAlign  align )

inline

Set field alignment type to use.

Parameters

align

Alignment type

Returns

This

operator<<() [2/34]

This& operator<< ( FmtWidth  width )

inline

Set field width to use.

Parameters

width

Field width to use

Returns

This

operator<<() [3/34]

This& operator<< ( const FmtSetField &  field )

inline

Set field attributes to use.

Parameters

field

Field attributes

Returns

This

operator<<() [4/34]

This& operator<< ( Newline  nl )

inline

Write an explicit newline and flush stream.

• Use NL for default newline value, where default is set by the stream

Parameters

nl	Newline value to write, NL_SYS for system default

Returns

This

operator<<() [5/34]

This& operator<< ( NewlineDefault  nl )

inline

Write default newline and flush stream.

• This overloads operator<<(Newline)

Parameters

nl	Default newline value (NL), where default is set by the stream

Returns

This

operator<<() [6/34]

This& operator<< ( const NewlineValue &  nl )

inline

Write newline value and flush stream.

Parameters

nl	Newline value to use, use current stream default if null

Returns

This

operator<<() [7/34]

This& operator<< ( Flush  )

inline

Flush buffer by writing to stream.

• This calls flush()
• This is useful when writing a console prompt, flush so the prompt is immediately visible

Returns

This

operator<<() [8/34]

This& operator<< ( const FmtSetNull &  null )

inline

Set attributes for null values.

Parameters

null	Null attributes

Returns

This

operator<<() [9/34]

This& operator<< ( bool  val )

inline

Append a bool value.

• Bool value is formatted as either "true" or "false" (without quotes)
• This calls writetext()

Parameters

val	Bool value to append

Returns

This

operator<<() [10/34]

This& operator<< ( char  ch )

inline

Append a character.

Parameters

ch	Character to append

Returns

This

operator<<() [11/34]

This& operator<< ( const FmtChar &  ch )

inline

Append a repeated character.

Parameters

ch	Character info to append

Returns

This

operator<<() [12/34]

This& operator<< ( const FmtString &  str )

inline

Append a formatted string.

Parameters

str	String info to append

Returns

This

operator<<() [13/34]

This& operator<< ( const char *  val )

inline

Append a terminated string.

• Field attributes apply

Parameters

val	String pointer, must be terminated, NULL for null string

Returns

This

operator<<() [14/34]

This& operator<< ( const ListBase< char, TSize > &  str )

inline

Append a string.

• Field attributes apply

Parameters

str	String value

Returns

This

operator<<() [15/34]

This& operator<< ( FmtBase  base )

inline

Set base for formatting integers.

Parameters

base	Base to use, see FmtBase

Returns

This

operator<<() [16/34]

This& operator<< ( FmtBasePrefix  prefix )

inline

Set prefix for formatting integers.

Parameters

prefix

Integer prefix to use, see FmtBasePrefix

Returns

This

operator<<() [17/34]

This& operator<< ( const FmtSetInt &  fmt_int )

inline

Set integer formatting attributes.

Parameters

fmt_int

Integer formatting attributes

Returns

This

operator<<() [18/34]

This& operator<< ( short  num )

inline

Append a formatted signed integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [19/34]

This& operator<< ( int  num )

inline

Append a formatted signed integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [20/34]

This& operator<< ( long  num )

inline

Append a formatted signed integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [21/34]

This& operator<< ( longl  num )

inline

Append a formatted signed integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [22/34]

This& operator<< ( ushort  num )

inline

Append a formatted unsigned integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [23/34]

This& operator<< ( uint  num )

inline

Append a formatted unsigned integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [24/34]

This& operator<< ( ulong  num )

inline

Append a formatted unsigned integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [25/34]

This& operator<< ( ulongl  num )

inline

Append a formatted unsigned integer.

• Integer and field attributes apply

Parameters

num	Integer to format

Returns

This

operator<<() [26/34]

This& operator<< ( const IntegerT< U > &  num )

inline

Append a formatted integer class.

• Integer, field, and null attributes apply

Template Parameters

T	Integer POD type, deduced from arguments

Parameters

num	Integer to format (Int, UInt, etc)

Returns

This

operator<<() [27/34]

This& operator<< ( FmtPrecision  prec )

inline

Set floating point formatting precision.

Parameters

prec	Precision value, see FmtPrecision

Returns

This

operator<<() [28/34]

This& operator<< ( const FmtSetFloat &  fmt_flt )

inline

Set floating point formatting attributes.

Parameters

fmt_flt

Floating point formatting attributes

Returns

This

operator<<() [29/34]

This& operator<< ( float  num )

inline

Append a formatting floating point number.

• Floating point and field attributes apply

Parameters

num	Number to format

Returns

This

operator<<() [30/34]

This& operator<< ( double  num )

inline

Append a formatting floating point number.

• Floating point and field attributes apply

Parameters

num	Number to format

Returns

This

operator<<() [31/34]

This& operator<< ( ldouble  num )

inline

Append a formatting floating point number.

• Floating point and field attributes apply

Parameters

num	Number to format

Returns

This

operator<<() [32/34]

This& operator<< ( const FloatT< U > &  num )

inline

Append a formatted integer class.

• Floating point, field, and null attributes apply

Template Parameters

T	Floating point POD type, deduced from arguments

Parameters

num	Number to format (Float, FloatD, etc)

Returns

This

operator<<() [33/34]

This& operator<< ( const FmtPtr &  fmtptr )

inline

Writer formatted pointer field to stream.

Parameters

fmtptr

Pointer info

Returns

This

operator<<() [34/34]

This& operator<< ( const FmtDump &  fmtdump )

inline

Write formatted data dump to stream.

Parameters

fmtdump

Dump info

Returns

This

operator=()

This& operator= ( const This &  src )

inline

Assignment operator copies attributes.

• This does not copy the referenced string

Parameters

src	Source to copy attributes from

Returns

This

write_out()

Out& write_out ( )

inline

Get parent output string.

Returns

Parent output string (this)

Member Data Documentation

fmt

FmtAttribs fmt

Formatting attributes (state)

out

Out& out

Associated output stream.

---

The documentation for this struct was generated from the following file:

• evo/iobase.h