NAME

free_form, new_form - form library

LIBRARY

Curses Form Library (libform, -lform)

SYNOPSIS



int free_form(FORM *form)

FORM * new_form(FIELD **fields)

DESCRIPTION

The function free_form() frees all the resources associated with the form and destroys the form. Calling new_form() will create a new form, set the form parameters to the current defaults and attach the passed fields to the form. The array of fields passed to new_form() must be terminated with a NULL pointer to indicate the end of the fields.

RETURN VALUES

Functions returning pointers will return NULL if an error is detected. The functions that return an int will return one of the following error values:

E_OK
The function was successful.
E_BAD_ARGUMENT
The function was passed a bad argument.
E_POSTED
The form is posted to the screen.

SEE ALSO

curses(3), forms(3)

NOTES

The header <form.h> automatically includes both <curses.h> and <eti.h>.