EN JA
curs_trace(3X)
curs_trace(3X) curs_trace(3X)

名称

_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)