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

December 31, 1996 FORM_NEW(3CURSES)