FORM_NEW(3CURSES) Curses Library Functions FORM_NEW(3CURSES)


NAME


form_new, new_form, free_form - create and destroy forms

SYNOPSIS


cc [ flag... ] file... -lform -lcurses [ library... ]
#include <form.h>

FORM *new_form(FIELD **fields);


int free_form(FORM *form);


DESCRIPTION


new_form() creates a new form connected to the designated fields and
returns a pointer to the form.


free_form() disconnects the form from its associated field pointer array
and deallocates the space for the form.

RETURN VALUES


new_form() always returns NULL on error. free_form() returns one of the
following:

E_OK
The function returned successfully.


E_BAD_ARGUMENT
An argument is incorrect.


E_POSTED
The form is posted.


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>.


illumos December 31, 1996 FORM_NEW(3CURSES)