define_key(3x) define_key(3x)
define_key
- キーコードを定義する
#include <curses.h>
int define_key(const char *definition, int keycode);
これは curses ライブラリに対する拡張機能です。
これを使うと、対応する制御文字列とともにキーコードを
定義することができ、 ncurses ライブラリはそれを
terminfo データベースで定義済みのコードと同様に解釈します。
与えられた文字列がヌルならば、そのキーコードに対して存在する
すべての定義は削除されます。
同様に、与えられたキーコードが負またはゼロならば、
与えられた定義に対して存在するすべての文字列は削除されます。
キーコードはゼロより大きくなければならず、文字列は
ヌルであってはならず、それ以外のとき、ERR を返します。
(訳注: 説明後半と整合するのか不明)
また、定義を格納するためのデータ領域を割り当てるために
十分なメモリがない場合にも ERR を返します。
エラーを検出しなかったとき、OK を返します。
このルーチンは ncurses 特有です。
Version 7, BSD, System V の実装ではサポートされていません。
このルーチンに依存するすべてのコードは、NCURSES_VERSION を
使って条件付きとすることを推奨します。
keyok(3x), key_defined(3x).
Thomas Dickey.
define_key(3x)