Manual Page Result
0
Command: form_field_info | Section: 3 | Source: OpenBSD | File: form_field_info.3
form_field_info(3) Library calls form_field_info(3)
NAME
dynamic_field_info, field_info - retrieve field characteristics
SYNOPSIS
#include <form.h>
int field_info(const FIELD *field,
int *rows, int *cols,
int *frow, int *fcol,
int *nrow, int *nbuf);
int dynamic_field_info(const FIELD *field,
int *rows, int *cols, int *max);
DESCRIPTION
The function field_info returns the sizes and other attributes passed
in to the field at its creation time. The attributes are: height,
width, row of upper-left corner, column of upper-left corner, number
off-screen rows, and number of working buffers.
The function dynamic_field_info returns the actual size of the field,
and its maximum possible size. If the field has no size limit, the lo-
cation addressed by the third argument will be set to 0. A field can
be made dynamic by turning off the O_STATIC option with field_opts_off.
RETURN VALUE
These routines return one of the following:
E_OK The routine succeeded.
E_SYSTEM_ERROR
System error occurred (see errno(3)).
E_BAD_ARGUMENT
Routine detected an incorrect or out-of-range argument.
SEE ALSO
curses(3) and related pages whose names begin "form_" for detailed de-
scriptions of the entry points.
NOTES
The header file <form.h> automatically includes the header file
<curses.h>.
PORTABILITY
These routines emulate the System V forms library. They were not sup-
ported on Version 7 or BSD versions.
A null (zero pointer) is accepted for any of the return values, to ig-
nore that value. Not all implementations allow this, e.g., Solaris 2.7
does not.
AUTHORS
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S.
Raymond.
ncurses 6.4 2022-02-12 form_field_info(3)