4 <STRONG>form_new</STRONG> - create and destroy forms
9 <STRONG>#include</STRONG> <STRONG><form.h></STRONG>
10 FORM *new_form(FIELD **fields);
11 int free_form(FORM *form);
15 <H2>DESCRIPTION</H2><PRE>
16 The function <STRONG>new_form</STRONG> creates a new form connected to a
17 specified field pointer array (which must be <STRONG>NULL</STRONG>-termi-
20 The function <STRONG>free_form</STRONG> disconnects <EM>form</EM> from its field
21 array and frees the storage allocated for the form.
25 <H2>RETURN VALUE</H2><PRE>
26 The function <STRONG>new_form</STRONG> returns <STRONG>NULL</STRONG> on error.
28 The function <STRONG>free_form</STRONG> returns one of the following:
30 <STRONG>E_OK</STRONG> The routine succeeded.
32 <STRONG>E_SYSTEM_ERROR</STRONG>
33 System error occurred (see <STRONG>errno</STRONG>).
35 <STRONG>E_BAD_ARGUMENT</STRONG>
36 Routine detected an incorrect or out-of-range argu-
39 <STRONG>E_POSTED</STRONG>
40 The form has already been posted.
44 <H2>SEE ALSO</H2><PRE>
45 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="form.3x.html">form(3X)</A></STRONG>.
50 The header file <STRONG><form.h></STRONG> automatically includes the header
51 file <STRONG><curses.h></STRONG>.
55 <H2>PORTABILITY</H2><PRE>
56 These routines emulate the System V forms library. They
57 were not supported on Version 7 or BSD versions.
62 Juergen Pfeifer. Manual pages and adaptation for new
63 curses by Eric S. Raymond.