名称

menu_new - メニューを作成するか破壊する

書式

#include <menu.h> MENU *new_menu(ITEM **items); int free_menu(MENU *menu);

解説

関数 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

メニューは既に記入されています。

関連項目

curses(3X), menu(3X)

注

ヘッダファイル <menu.h> は自動的にヘッダファイル <curses.h> を含んでいます。

移植性

これらのルーチンは、System V メニューライブラリをエミュレートします。それらは、Version 7 または BSD バージョンではサポートされませんでした。

作者

Juergen Pfeifer。マニュアルページと新しい curses の適応は、Eric S. Raymond。