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)