unctrl, keyname, filter, use_env, putwin, getwin, delay_output, flushinp - miscellaneous ncurses utility routines

#include <ncurses.h>

char *unctrl(chtype c);
char *keyname(int c);
int filter(void);
void use_env(char bool);
int putwin(WINDOW *win, FILE *filep);
WINDOW *getwin(FILE *filep);
int delay_output(int ms);
int flushinp(void);

unctrl マクロは、キャラクタ c の印刷可能な表現であるキャラクタストリ ン グ に展開されます。制御キャラクタは ^X 表記で表示されます。印刷キャラク タはそのとおりに表示されます。

keyname ルーチンは、キー c に対応するキャラクタストリングを返します。

filter ルーチンを使用する場合は、 initscr または newterm の前に呼び出す 必 要 が あ り ます。そうすると ncurses は 1 行画面があると認識します。 ncurses は、画面のどの行にカーソルが配置されているか認識できることを 想 定する端末機能を使用しません。

use_env ルーチンを使用する場合は、 initscr または newterm の前に呼び出 す必要があります。引数として FALSE を指定して 呼 び 出 さ れ た 場 合、 terminfo データベースに指定された line と column の値が使用されます。環 境変数 LINES と COLUMNS ( デフォルトで使用されます ) が設定されて い て も、 ま た は ncurses がウィンドウで実行されていてもです ( この場合、 LINES と COLUMNS が設定されていない場合、デフォルトの動作ではウィンドウ サイズを使用します ) 。

putwin ルーチンは、ウィンドウ win に対応するすべてのデータを filep が指 すファイルに書き込みます。この情報は、 getwin 関数を使用して後で取り 出 すことができます。

getwin ルーチンは、 putwin によってファイルに保存されたウィンドウ関連 データを読み取ります。次に、このルーチンは、そのデータを使用して新し い ウィ ンドウを作成および初期化し、新しいウィンドウを指すポインタを返して きます。

delay_output ルーチンは、出力に ms ミリ秒を挿入します。このルーチンは広 汎に使用しないでください。 CPU 休止ではなくパッドキャラクタが使用される からです。

flushinp ルーチンは、ユーザが入力し、プログラムがまだ読み取っていない入 力ヘッドを廃棄します。

flushinp を除いて、すべてのルーチンが、処理失敗すると整数 ERR を返して きます。処理が正常に完了した場合は、 ERR 以外の整数値を返します。

flushinp は必ず OK を返します。

ポインタを返すルーチンはエラーがあった場合は NULL を返します。

filter フィルタエントリ点はまだサポートされていません。

unctrl はマクロであることに注意してください。これは <unctrl.h> 内に定義 されています。

ncurses(3), curs_initscr(3), curs_scr_dmp(3).