H39792 s 00072/00000/00000 d D 1.1 02/05/02 15:35:04 root 2 1 cC cF1 cK08544 cO-rw-rw-r-- e s 00000/00000/00000 d D 1.0 02/05/02 15:35:04 root 1 0 c BitKeeper file /Mastodon/Core/Build/ncurses/Ada95/html/form_new.3x.html cBor@egypt.pell.portland.or.us|ChangeSet|20020502223039|07086|e73225ae258b78f8 cHegypt.pell.portland.or.us cK28988 cPAda95/html/form_new.3x.html cRd1c141c8d1291864 cV4 cX0x821 cZ-07:00 e u U f e 0 f x 0x821 t T I 2
       form_new - create and destroy forms


SYNOPSIS

       #include <form.h>
       FORM *new_form(FIELD **fields);
       int free_form(FORM *form);


DESCRIPTION

       The  function  new_form  creates a new form connected to a
       specified field pointer array (which must  be  NULL-termi-
       nated).

       The  function  free_form  disconnects  form from its field
       array and frees the storage allocated for the form.


RETURN VALUE

       The function new_form returns NULL on error.

       The function free_form returns one of the following:

       E_OK The routine succeeded.

       E_SYSTEM_ERROR
            System error occurred (see errno).

       E_BAD_ARGUMENT
            Routine detected an incorrect or  out-of-range  argu-
            ment.

       E_POSTED
            The form has already been posted.


SEE ALSO

       curses(3X), form(3X).


NOTES

       The header file <form.h> automatically includes the header
       file <curses.h>.


PORTABILITY

       These routines emulate the System V forms  library.   They
       were not supported on Version 7 or BSD versions.


AUTHORS

       Juergen  Pfeifer.   Manual  pages  and  adaptation for new
       curses by Eric S. Raymond.






E 2 I 1 E 1