FORM_FIELD_USERPTR(3CURSES) Curses Library Functions
form_field_userptr, set_field_userptr, field_userptr - associate
application data with forms
cc [ flag... ] file... -lform -lcurses [ library... ]
#include <form.h>
int set_field_userptr(FIELD *field, char *ptr);
char *field_userptr(FIELD *field);
Every field has an associated user pointer that can be used to store
pertinent data. set_field_userptr() sets the user pointer of field.
field_userptr() returns the user pointer of field.
field_userptr() returns NULL on error. set_field_userptr() returns
one of the following:
E_OK
The function returned successfully.
E_SYSTEM_ERROR
System error.
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
curses(3CURSES), forms(3CURSES), attributes(7)
The header <form.h> automatically includes the headers <eti.h> and
<curses.h>.
December 31, 1996 FORM_FIELD_USERPTR(3CURSES)
NAME
form_field_userptr, set_field_userptr, field_userptr - associate
application data with forms
SYNOPSIS
cc [ flag... ] file... -lform -lcurses [ library... ]
#include <form.h>
int set_field_userptr(FIELD *field, char *ptr);
char *field_userptr(FIELD *field);
DESCRIPTION
Every field has an associated user pointer that can be used to store
pertinent data. set_field_userptr() sets the user pointer of field.
field_userptr() returns the user pointer of field.
RETURN VALUES
field_userptr() returns NULL on error. set_field_userptr() returns
one of the following:
E_OK
The function returned successfully.
E_SYSTEM_ERROR
System error.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+
SEE ALSO
curses(3CURSES), forms(3CURSES), attributes(7)
NOTES
The header <form.h> automatically includes the headers <eti.h> and
<curses.h>.
December 31, 1996 FORM_FIELD_USERPTR(3CURSES)