1form_new(3X)                                                      form_new(3X)
2
3
4

NAME

6       new_form, free_form - create and destroy forms
7

SYNOPSIS

9       #include <form.h>
10
11       FORM *new_form(FIELD **fields);
12       int free_form(FORM *form);
13

DESCRIPTION

15       The function new_form creates a new form connected to a specified field
16       pointer array (which must be NULL-terminated).
17
18       The function free_form disconnects form from its field array and  frees
19       the storage allocated for the form.
20

RETURN VALUE

22       The  function  new_form returns NULL on error.  It sets errno according
23       to the function's success:
24
25       E_OK The routine succeeded.
26
27       E_BAD_ARGUMENT
28            Routine detected an incorrect or out-of-range argument.
29
30       E_CONNECTED
31            The field is already connected to a form.
32
33       E_SYSTEM_ERROR
34            System error occurred, e.g., malloc failure.
35
36       The function free_form returns one of the following:
37
38       E_OK The routine succeeded.
39
40       E_BAD_ARGUMENT
41            Routine detected an incorrect or out-of-range argument.
42
43       E_POSTED
44            The form has already been posted.
45

SEE ALSO

47       curses(3X), form(3X).
48

NOTES

50       The  header  file  <form.h>  automatically  includes  the  header  file
51       <curses.h>.
52

PORTABILITY

54       These  routines emulate the System V forms library.  They were not sup‐
55       ported on Version 7 or BSD versions.
56

AUTHORS

58       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
59       Raymond.
60
61
62
63                                                                  form_new(3X)