名称

_tracef, _tracedump, _traceattr, _traceattr2, _nc_tracebits, _tracechar, _tracechtype, _tracechtype2, _tracemouse, trace - curses デバッグルーチン

書式

#include <curses.h> void _tracef(const char *format, ...); void _tracedump(const char *label, WINDOW *win); char *_traceattr(attr_t attr); char *_traceattr2(int buffer, chtype ch); char *_nc_tracebits(void); char *_tracechar(int); char *_tracechtype(chtype ch); char *_tracechtype2(int buffer, chtype ch); char *_tracemouse(const MEVENT *event); void trace(const unsigned int param);

解説

trace ルーチンは、ncurses ライブラリを使用するアプリケーションと同様に ncurses ライブラリをデバッグするために使用されます。これらの関数は、通常デバッグライブラリ libncurses_g.a でのみ利用可能ですが、シンボル TRACE を定義することによって任意のモデル (共有、静的、プロファイル) にコンパイルすることができます。

このインタフェースの主要部分は、異なるトレース機能を選択的に有効にする trace ルーチン、と trace ファイルに書式化されたデータを書き込む _tracef ルーチンです。

0 でないパラメータをつけて trace を呼び出すことは、カレントディレクトリのファイル trace を出力のためにオープンします。パラメータは、 <curses.h> の TRACE_xxx 定義のリストから値を論理和 (OR) することにより形成されます。これらは、次のものを含んでいます:

TRACE_DISABLE

トレースをオフに切り替えます。

TRACE_TIMES

ユーザとシステムの更新時間をトレースします。

TRACE_TPUTS

tputs 呼び出しをトレースします。

TRACE_UPDATE

更新の動作、古い &新しい画面をトレースします。

TRACE_MOVE

カーソルの移動とスクロールをトレースします。

TRACE_CHARPUT

すべての文字出力をトレースします。

TRACE_ORDINARY

すべての更新の動作をトレースします。古い画面の新しい画面の内容は、各リフレッシュのためのトレースファイルに書き込まれます。

TRACE_CALLS

すべての curses 呼び出しをトレースします。各呼び出しのためのパラメータは、返り値と同様にトレースされます。

TRACE_VIRTPUT

実際上の文字の出力 (put)、すなわち addch の呼び出し、をトレースします。

TRACE_IEVENT

タイムアウトを含んで、低レベル入力処理をトレースします。

TRACE_BITS

TTY 制御ビットの状態をトレースします。

TRACE_ICALLS

内部の/ネストした呼び出しをトレースします。

TRACE_CCALLS

文字ごとの呼び出しをトレースします。

TRACE_DATABASE

terminfo/termcap データの読み込み/書き込みをトレースします。

TRACE_ATTRS

ビデオ属性と色の変化をトレースします。

TRACE_MAXIMUM

最大のトレースレベル、個別のトレース機能のすべてを有効にします。

trace パラメータが 0 でないときはいつでも、いくつかのトレース機能が、有効にされます。いくつかの機能は、オーバラップしています。特有の名前は、ガイドラインとして使用されます。

戻り値

値を返すルーチンは、 _tracef ルーチンへのパラメータとして使用されるように設計されています。

移植性

これらの関数は、XSI インタフェースの一部ではありません。他のいくつかの curses 実装は、同様に文書化されていない機能があることが知られていますが、それらは、ncurses と互換性がありません。

関連項目

curses(3X)