EN JA
form_new(3X)
form_new(3X) form_new(3X)

名称

form_new - form の作成および破壊

書式

#include <form.h>
 
FORM *new_form(FIELD **fields);
 
int free_form(FORM *form);
 

解説

関数 new_form は、指定されたフィールドポインタ配列 (それは、 NULL 終了するべきです) に接続された新しい from を作成します。

関数 free_form はそのフィールド配列から form を切断し、 form に割り付けられた記憶域を解放します。

戻り値

関数 new_form は、エラーの場合 NULL を返します。それは、関数が成功したかどうかに従って、errno を設定します:
E_OK
ルーチンが成功した。
E_BAD_ARGUMENT
ルーチンは正しくないか範囲外の引数を検知しました。
E_CONNECTED
フィールドは、form に既に接続されます。
E_SYSTEM_ERROR
システムエラーが生じた、例えば、malloc の失敗。

関数 free_form は、次の 1 つを返します:

E_OK
ルーチンが成功した。
E_BAD_ARGUMENT
ルーチンは正しくないか範囲外の引数を検知しました。
E_POSTED
form は既に記入されています。

関連項目

curses(3X), form(3X)

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

移植性

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

作者

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