名称

form_userptr - form 項目にアプリケーションデータを関連付ける

書式

#include <form.h> int set_form_userptr(FORM *form, void *userptr); void* form_userptr(const FORM *form);

解説

すべての form およびすべての form 項目は、アプリケーションに特有のデータ (すなわち、form ドライバコードはそれをそのままにしておきます) を保持するために使用することができるフィールドを持っています。これらの関数は、form ユーザポインタフィールドを得て設定します。

戻り値

関数 form_userptr は、( NULL であるかもしれない) ポインタを返します。それは、errno を設定しません。

関数 set_form_userptr は、 E_OK (成功) を返します。

関連項目

curses(3X), form(3X)

注

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

移植性

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

ユーザポインタ (userptr) は、void ポインタです。私たちは、SVr4 の互換のための char ポインタとしてそれを残さないことを選びました。

作者

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