1 / 3

TWE

基本クラス、関数

IStreamOut

本クラスは namespace TWE 内に定義されています。

出力ストリームの基底クラスで、以下のメソッドが定義されており、１バイトの出力、改行文字など特殊クラスを受け付けるためのメソッドが定義されています。

virtual inline IStreamOut& operator ()(char_t c) = 0
virtual inline IStreamOut& write_w(wchar_t c)

operator () はchar_t型の１文字を出力するための仮想関数です。write_w()はwchar_t型の出力に対応します。

ストリームへの出力は<<演算子を用います。最終的には上記の出力用の関数が呼び出されます。

以下の例はITermクラスでの実装例です。

class ITerm : public TWE::IStreamOut {
  // ... 各種定義
  
  ITerm& write(char_t c) {
    // ... １バイト入力を受け付ける処理
  }
  
  // StreamOut::operator () の実装
  TWE::IStreamOut& operator ()(char_t c) {
    write(c);
    return *this;
  }
};

operator <<

inline IStreamOut& operator << (char_t c)
inline IStreamOut& operator << (wchar_t c)
inline IStreamOut& operator << (IStreamSpecial& sc)

operator << の右オペランドとして以下の型に対応します。

曖昧性の解決のため、派生クラスで明示的なオーバーライドが必要になる場合があります。

inline ITerm& operator << (ITerm& t, char_t c)
   { *static_cast<TWE::IStreamOut*>(&t) << c; return t; }

IStreamSpecial

特殊な文字列などを指定するためのオブジェクトを定義するための基底クラスです。

class IStreamSpecial {
	public:
		virtual inline IStreamOut& operator ()(IStreamOut& of) = 0;
};

派生クラスとして CR LF (0x0d 0x0a) を出力する IStream_endl が定義されています。

class IStream_endl : public IStreamSpecial {
  inline IStreamOut& operator ()(IStreamOut& of) { 
    // ... CR LF の出力
    of ('\r');
    of ('\n');
  }
};

IStream_endl crlf;

オブジェクトcrlfは以下のように使用します。

the_screen << "Hello World!" << crlf;

Print Formatted

printfmt, fPrintf(), snPrintf()

printf, sprintfに対応する処理を行います。

本ライブラリではMacro Poland氏のprintf,sprintfライブラリを利用しています。 https://github.com/mpaland/printf

printfmt

ストリームIStreamOutオブジェクトに対して<<演算子の右オペランドとして利用します。

printfmt(const char*fmt, ...)
ISteramOut& operator << (IStreamOut& strm, printfmt f)

//例
  the_screen << printfmt("%04X", 0x12ab) << crlf;

printfmtクラスのコストラクタのパラメータの１番目fmtに書式を指定します。以降のパラメータはC++テンプレートのパラメータパックで実装されており可変数引数となっています。printfのように書式に対応した引数を指定します。printfと違い引数の数は最大４つに制限されます。

fPrintf()

ストリームIStreamOutオブジェクトを出力先としてfprintfと同じ処理を行います。

int fPrintf(TWE::IStreamOut& fp, const char* format, ...)

１番目の引数がストリームオブジェクトとなる点を除きfprintfと同じ使い方です。

snPrintf()

snprintfの処理を行います。

int snPrintf(char* buffer, size_t count, const char* format, ...)