form_new(3X) | form_new(3X) |
名称
form_new - form の作成および破壊書式
#include <form.h>解説
関数 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 は既に記入されています。