FORMS(3)

FORMS(3) | Library Functions Manual | FORMS(3)

# NAME

free_form, new_form — form library

# LIBRARY

Curses Form Library (libform, -lform)

# SYNOPSIS

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

# DESCRIPTION

The function free_form() frees all the resources associated with the form and destroys the form. Calling new_form() will create a new form, set the form parameters to the current defaults and attach the passed fields to the form. The array of fields passed to new_form() must be terminated with a `NULL` pointer to indicate the end of the fields.

# RETURN VALUES

Functions returning pointers will return `NULL` if an error is detected. The functions that return an int will return one of the following error values:

`E_OK`
  The function was successful.
`E_BAD_ARGUMENT`
  The function was passed a bad argument.
`E_POSTED`
  The form is posted to the screen.

# SEE ALSO

curses(3), forms(3)

# NOTES

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

January 1, 2001 | NetBSD 8.3