NAME    [Toc]    [Back]

     free_form, new_form - form library

LIBRARY    [Toc]    [Back]

     library ``libform''

SYNOPSIS    [Toc]    [Back]

     #include <form.h>

     int
     free_form(FORM *form);

     FORM *
     new_form(FIELD **fields);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     curses(3), forms(3)

NOTES    [Toc]    [Back]

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

BSD                             January 1, 2001                            BSD