'\"!  tbl | mmdoc
'\"macro stdmacro
.if n .pH g3x.form_f_info @(#)form_f_info	40.3 of 12/15/89
.\" Copyright 1989 AT&T
.\" ident	"@(#)svid_ti:ti_lib/form_f_info	1.4"
.nr X
.if \nX=0 .ds x} form_field_info 3X "" "\&"
.if \nX=1 .ds x} form_field_info 3X ""
.if \nX=2 .ds x} form_field_info 3X "" "\&"
.if \nX=3 .ds x} form_field_info "" "" "\&"
.TH \*(x}
.SH NAME
.na
\f4form_field_info\f2: \f4 field_info\f1, \f4dynamic_field_info\f1 \- get \f4forms\fP field characteristics
.ad
.SH SYNOPSIS
.nf
.ft 4
#include <form.h>
.sp
int field_info(FIELD *field, int *rows, int *cols,
	int *frow, int *fcol, int *nrow, int *nbuf);
.sp 0.5
int dynamic_field_info(FIELD *field, int *drows, int *dcols,
	int *max);
.ft 1
.fi
.SH DESCRIPTION
\f4field_info\fP returns the size, position, and other named field
characteristics, as defined in the original call to \f4new_field\f1,
to the locations pointed to by the arguments \f2rows\f1, \f2cols\f1,
\f2frow\f1, \f2fcol\f1, \f2nrow\f1, and \f2nbuf\f1.
.PP
\f4dynamic_field_info\fP returns the actual size of the \f2field\f1
in the pointer arguments \f2drows\f1, \f2dcols\f1 and returns the maximum
growth allowed for \f2field\f1 in \f2max\f1.
If no maximum growth limit is specified for \f2field\f1,
\f2max\f1 will contain 0.
A field can be made dynamic by turning off the field option \f4O_STATIC\fP.
.SH RETURN VALUE
These routines return one of the following:
.TS
lfCWw(1.25i)1 c1 l .
E_OK	\-	The function returned successfully.
E_SYSTEM_ERROR	\-	System error.
E_BAD_ARGUMENT	\-	An argument is incorrect.
.TE
.SH NOTES
.PP
The header file \f4<form.h>\f1 automatically includes the header files
\f4<eti.h>\fP and \f4<curses.h>\fP.
.SH SEE ALSO
\f4curses\fP(3X),
\f4forms\fP(3X).
