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

NAME

6       form_new - create and destroy forms
7

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

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

SEE ALSO

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

NOTES

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

PORTABILITY

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

AUTHORS

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