form_new(3curses)


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.

 
 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)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.