EN JA
mitem_new(3X)
mitem_new(3X) mitem_new(3X)

名称

mitem_new - メニューアイテム (項目) を作成するか破壊する

書式

#include <menu.h>
 
ITEM *new_item(const char *name, const char *description);
 
int free_item(ITEM *item);
 

解説

関数 new_item は新しいアイテム (項目) を割り付けて、 namedescription ポインタからそれを初期化します。アイテムが name (名前) および description (記述) へのポインタだけを格納することに注意してください。それらのポインタはアイテムの存続期間の間、有効でなければなりません。したがって、いくつかのルーチンのスタックに割り付けられた name (名前) あるいは description (記述) に非常に注意するべきです。
 
関数 free_item はアイテムの割り付けを解放します。それは、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 参照)。

関連項目

curses(3X), menu(3X)

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

移植性

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

作者

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