menu_pattern(3X) | menu_pattern(3X) |
名称
menu_pattern - メニューのパターンバッファを取得するか設定する書式
#include <menu.h>解説
すべてのメニューは、関連するパターンマッチバッファを持っています。印刷可能な文字が入ってきた入力イベントの時に、それらは、このマッチバッファに追加され、 menu_driver(3X) で記述されるように、一致するかテストされます。関数 set_menu_pattern は、与えられたメニューのパターンバッファを設定し、最初に一致する項目を見つけようとします。成功する場合、その項目は、カレント(現在)になります。そうでなければ、現在の項目は、変わりません。
関数 menu_pattern は、与えられた menu のパターンバッファを返します。
戻り値
関数 menu_pattern は、 menu パラメータが NULL であるなら、 NULL である、ポインタを返します。そうでなければ、パターンが設定されていないなら、空の文字列へのポインタです。それは、errno を設定しません。関数 set_menu_pattern は、次のエラーコードを返します:
- E_OK
- ルーチンが成功した。
- E_BAD_ARGUMENT
- ルーチンは、正しくないか範囲外の引数を検知しました。
- E_BAD_STATE
- ルーチンは、初期化または終了の関数から呼ばれました。
- E_NOT_CONNECTED
- 項目は、メニューに接続されていません。
- E_NO_MATCH
- 文字は、一致しませんでした。
- E_SYSTEM_ERROR
- システムエラーが生じた ( errno 参照)。