スポンサーリンク

curs_util

名称
書式
解説
戻り値
バグ
注釈
関連項目

名称

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 データベースに指定された linecolumn の値が使用されます。環 境変数 LINESCOLUMNS ( デフォルトで使用されます ) が設定されて い て も、 ま た は ncurses がウィンドウで実行されていてもです ( この場合、 LINESCOLUMNS が設定されていない場合、デフォルトの動作ではウィンドウ サイズを使用します ) 。

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

スポンサーリンク