form_field(3X) | form_field(3X) |
名称
form_field - フィールドと form の関係の作成と破壊書式
#include <form.h>解説
関数 set_form_fields は、与えられた form のフィールドポインタの配列を変更します。配列は、 NULL で終了しなければなりません。関数 form_fields は、与えられた form のフィールド配列を返します。
関数 field_count は、 form 中のフィールドを数えた数を返します。
関数 move_field は、画面上の指定された位置に与えられたフィールド (それは分離されるに違いない) を移動させます。
戻り値
関数 form_fields は、エラーの場合 NULL を返します。関数 field_count は、 form パラメータが NULL であるなら ERR を返します。
関数 set_form_fields と move_field は、エラーの場合、次のコードの 1 つを返します:
- E_OK
- ルーチンが成功した。
- E_BAD_ARGUMENT
- ルーチンは正しくないか範囲外の引数を検知しました。
- E_CONNECTED
- フィールドは、既に form に接続されています。
- E_POSTED
- form は既に記入されています。
- E_SYSTEM_ERROR
- システムエラーが生じた ( errno 参照)。
関連項目
curses(3X), form(3X)注
ヘッダファイル <form.h> は、自動的にヘッダファイル <curses.h> を含んでいます。移植性
これらのルーチンは、System V メニューライブラリをエミュレートします。それらは、Version 7 または BSD バージョンではサポートされませんでした。SVr4 form ライブラリドキュメンテーションは、 field_count のエラー値として -1 ( ERR の値) を仕様化しています。