mitem_new(3X) | mitem_new(3X) |
名称
mitem_new - メニューアイテム (項目) を作成するか破壊する書式
#include <menu.h>解説
関数 new_item は新しいアイテム (項目) を割り付けて、 name と description ポインタからそれを初期化します。アイテムが name (名前) および description (記述) へのポインタだけを格納することに注意してください。それらのポインタはアイテムの存続期間の間、有効でなければなりません。したがって、いくつかのルーチンのスタックに割り付けられた name (名前) あるいは description (記述) に非常に注意するべきです。戻り値
関数 new_item は、エラーの場合 NULL を返します。それは、成功したかどうかに従って、errno を設定します:- E_BAD_ARGUMENT
- ルーチンは正しくないか範囲外の引数を検知しました。
- E_SYSTEM_ERROR
- システムエラーが生じた、例えば、malloc の失敗。
関数 free_item は、次の 1 つを返します:
- E_OK
- ルーチンが成功した。
- E_BAD_ARGUMENT
- ルーチンは正しくないか範囲外の引数を検知しました。
- E_CONNECTED
- アイテムはメニューに接続されます。
- E_SYSTEM_ERROR
- システムエラーが生じた ( errno 参照)。