form_new(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
FORMS(3)                NetBSD 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>.

NetBSD 5.0                      January 1, 2001                     NetBSD 5.0