form_field_buffer(3X)form_field_buffer(3X)NAMEform_field_buffer - field buffer control
SYNOPSIS
#include <form.h>
int set_field_buffer(FIELD *field, int buf, const char *value);
char *field_buffer(const FIELD *field, int buffer);
int set_field_status(FIELD *field, bool status);
bool field_status(const FIELD *field);
int set_max_field(FIELD *field, int max);
DESCRIPTION
The function set_field_buffer sets the numbered buffer of the given
field to contain a given string. Buffer 0 is the displayed value of
the field; other numbered buffers may be allocated by applications
through the nbuf argument of (see form_field_new(3X)) but are not
manipulated by the forms library. The function field_buffer returns
the foreground attribute.
The function set_field_status sets the associated status flag of field;
field_status gets the current value. The status flag is set to a
nonzero value whenever the field changes.
The function set_max_field sets the maximum size for a dynamic field.
An argument of 0 turns off any maximum size threshold for that field.
RETURN VALUE
The field_buffer function returns NULL on error.
The field_status function returns TRUE or FALSE.
The remaining routines return one of the following:
E_OK The routine succeeded.
E_SYSTEM_ERROR
System error occurred (see errno).
E_BAD_ARGUMENT
Routine detected an incorrect or out-of-range argument.
SEE ALSOcurses(3X) and 3X pages whose names begin "form_" for detailed descrip‐
tions 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.
AUTHORS
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S.
Raymond.
form_field_buffer(3X)