form_new(3X)

NAME

form_new, new_form, free_form − create and destroy forms

#include <form.h>

FORM ∗new_form(FIELD ∗∗fields);

int free_form(FORM ∗form);

Unsafe

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.

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.

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