EN JA
menu_new(3X)
menu_new(3X) menu_new(3X)

名称

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。