form_new(3curses)                                  form_new(3curses)


       NAME
             form_new: new_form, free_form - create and destroy forms

       SYNOPSIS
             cc [flag . . .] file -lform -lcurses [library . . .]
             #include <form.h>
             FORM *new_form(FIELD **fields);
             int free_form(FORM *form);

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

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

       NOTICES
             The header file form.h automatically includes the header files
             eti.h and curses.h.

       REFERENCES
             curses(3curses), forms(3curses)



















                           Copyright 1994 Novell, Inc.               Page 1