Content-type: text/html Man page of form_new

form_new

Section: Curses Library Functions (3CURSES)
Updated: 31 Dec 1996
Index Return to Main Contents
 

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 VALUES

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.

 

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
MT-LevelUnsafe

 

SEE ALSO

curses(3CURSES), forms(3CURSES), attributes(5)  

NOTES

The header <form.h> automatically includes the headers <eti.h> and <curses.h>.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:38:35 GMT, October 02, 2010