NAME
free_form,
new_form —
form library
LIBRARY
Curses Form Library (libform, -lform)
SYNOPSIS
#include <form.h>
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>.