menu_new(3X) | menu_new(3X) |
名称
menu_new - メニューを作成するか破壊する書式
#include <menu.h>解説
関数 new_menu は、指定された項目ポインタ配列 (それは、 NULL で終了するべきです) に接続された新しいメニューを作成します。関数 free_menu はその項目配列から menu を切断し、メニューに割り付けられた記憶域を解放します。
戻り値
関数 new_menu は、エラーの場合 NULL を返します。次の、関数の失敗にしたがって errno を設定します:- E_NOT_CONNECTED
- 項目はメニューに接続されていません。
- E_SYSTEM_ERROR
- システムエラーが生じた、例えば malloc の失敗。
関数 free_menu は、次の一つを返します:
- E_OK
- ルーチンが成功した。
- E_SYSTEM_ERROR
- システムエラーが生じた ( errno 参照)。
- E_BAD_ARGUMENT
- ルーチンは正しくないか範囲外の引数を検知しました。
- E_POSTED
- メニューは既に記入されています。