1form_new(3CURSES)          Curses Library Functions          form_new(3CURSES)
2
3
4

NAME

6       form_new, new_form, free_form - create and destroy forms
7

SYNOPSIS

9       cc [ flag... ] file... -lform  -lcurses  [ library... ]
10       #include <form.h>
11
12       FORM *new_form(FIELD **fields);
13
14
15       int free_form(FORM *form);
16
17

DESCRIPTION

19       new_form()  creates  a  new form connected to the designated fields and
20       returns a pointer to the form.
21
22
23       free_form() disconnects the form  from  its  associated  field  pointer
24       array and deallocates the space for the form.
25

RETURN VALUES

27       new_form() always returns NULL on error. free_form() returns one of the
28       following:
29
30       E_OK              The function returned successfully.
31
32
33       E_BAD_ARGUMENT    An argument is incorrect.
34
35
36       E_POSTED          The form is posted.
37
38

ATTRIBUTES

40       See attributes(5) for descriptions of the following attributes:
41
42
43
44
45       ┌─────────────────────────────┬─────────────────────────────┐
46       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
47       ├─────────────────────────────┼─────────────────────────────┤
48       │MT-Level                     │Unsafe                       │
49       └─────────────────────────────┴─────────────────────────────┘
50

SEE ALSO

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

NOTES

55       The header <form.h> automatically includes  the  headers   <eti.h>  and
56       <curses.h>.
57
58
59
60SunOS 5.11                        31 Dec 1996                form_new(3CURSES)