netbsd man page for form_new

FORMS(3)						   BSD Library Functions Manual 						  FORMS(3)

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

BSD
								  January 1, 2001							       BSD