Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: Thursday, June 13, 2019
 
 

field_index(3CURSES)

Name

form_page, set_form_page, set_current_field, current_field, field_index - set forms current page and field

Synopsis

cc [ flag... ] file... –lform –lcurses [ library... ]
#include <form.h>

int set_form_page(FORM *form, int page);
int form_page(FORM *form);
int set_current_field(FORM *form, FIELD *field);
FIELD *current_field(FORM*form);
int field_index(FIELD *field);

Description

set_form_page() sets the page number of form to page. form_page() returns the current page number of form.

set_current_field() sets the current field of form to field. current_field() returns a pointer to the current field of form.

field_index() returns the index in the field pointer array of field.

Return Values

form_page() returns -1 on error.

current_field() returns NULL on error.

field_index() returns -1 on error.

set_form_page() and set_current_field() return one of the following:

E_OK

The function returned successfully.

E_SYSTEM_ERROR

System error.

E_BAD_ARGUMENT

An argument is incorrect.

E_BAD_STATE

The routine was called from an initialization or termination function.

E_INVALID_FIELD

The field contents are invalid.

E_REQUEST_DENIED

The form driver request failed

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
Unsafe

See Also

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

Notes

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