form_field_buffer()

NAME

set_field_buffer(), field_buffer(), set_field_status(), field_status(), set_max_field() - field buffer control

SYNOPSIS

#include <form.h>

int set_field_buffer(FIELD *field, int buf, char *value); char *field_buffer(FIELD *field, int buffer); int set_field_status(FIELD *field, int status); int field_status(FIELD *field); int set_max_field(FIELD *field, int max);

DESCRIPTION

The function set_field_buffer(3) 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 nbuffers argument of new_field(3) but are not manipulated by the forms library. The function field_buffer(3) returns the foreground attribute.

The function set_field_status(3) sets the associated status flag of field; field_status(3) gets the current value. The status flag is set to a nonzero value whenever the field changes.

The function set_max_field(3) 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(3) function returns NULL on error.

The field_status(3) function returns TRUE or FALSE.

The remaining routines return one of the following:

E_OK
The routine succeeded.
E_SYSTEM_ERROR
errno )
E_BAD_ARGUMENT
Routine detected an incorrect or out-of-range argument.

SEE ALSO

curses(3)

new_field(3)

forms(3) and 3X pages whose names begin form_ for detailed descriptions 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 supported on Version 7 or BSD versions.