form_field_info(S)

form_field_info: field_info, dynamic_field_info -- get forms field characteristics

Syntax

cc ... -lform -lcurses

#include <form.h>

int field_info(FIELD *field, int *rows, int *cols, int *frow, int *fcol,
	int *nrow, int *nbuf);
int dynamic_field_info(FIELD *field, int *drows, int *dcols, int *max);

Description

field_info(S) returns the size, position, and other named field characteristics, as defined in the original call to new_field(S), to the locations pointed to by the arguments rows, cols, frow, fcol, nrow, and nbuf.

dynamic_field_info(S) returns the actual size of the field in the pointer arguments drows, dcols and returns the maximum growth allowed for field in max. If no maximum growth limit is specified for field, max contains 0. A field can be made dynamic by turning off the field option O_STATIC.

Return values

These routines return one of the following:

E_OK - The function returned successfully.

E_SYSTEM_ERROR - System error.

E_BAD_ARGUMENT - An argument is incorrect.

Warning

The header file form.h automatically includes the header files eti.h and curses.h.

Files

/usr/lib/libform.a: the library

Standards conformance

field_info(S) and dynamic_field_info(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`E_OK`	-	The function returned successfully.
`E_SYSTEM_ERROR`	-	System error.
`E_BAD_ARGUMENT`	-	An argument is incorrect.