1form_userptr(3X)                                              form_userptr(3X)
2
3
4

NAME

6       form_userptr - associate application data with a form item
7

SYNOPSIS

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

DESCRIPTION

14       Every  form  and  every  form item has a field that can be used to hold
15       application-specific data (that is,  the  form-driver  code  leaves  it
16       alone).  These functions get and set the form user pointer field.
17

RETURN VALUE

19       The  function  form_userptr  returns a pointer (which may be NULL).  It
20       does not set errno.
21
22       The function set_form_userptr returns E_OK (success).
23

SEE ALSO

25       curses(3X), form(3X).
26

NOTES

28       The  header  file  <form.h>  automatically  includes  the  header  file
29       <curses.h>.
30

PORTABILITY

32       These  routines emulate the System V forms library.  They were not sup‐
33       ported on Version 7 or BSD versions.
34
35       The user pointer is a void pointer.  We chose not to leave it as a char
36       pointer for SVr4 compatibility.
37

AUTHORS

39       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
40       Raymond.
41
42
43
44                                                              form_userptr(3X)
Impressum