FORM_FIELD_BUFFER(3CURSES) Curses Library Functions FORM_FIELD_BUFFER(3CURSES)


NAME


form_field_buffer, set_field_buffer, field_buffer, set_field_status,
field_status, set_max_field - set and get forms field attributes

SYNOPSIS


cc [ flag... ] file... -lform -lcurses [ library... ]
#include <form.h>


int set_field_buffer(FIELD *field, int buf, char *value);


char *field_buffer(FIELD *field, int buf);


int set_field_status(FIELD *field, int status);


int field_status(FIELD *field);


int set_max_field(FIELD *field, int max);


DESCRIPTION


set_field_buffer() sets buffer buf of field to value. Buffer 0 stores
the displayed contents of the field. Buffers other than 0 are application
specific and not used by the forms library routines. field_buffer()
returns the value of field buffer buf.


Every field has an associated status flag that is set whenever the
contents of field buffer 0 changes. set_field_status() sets the status
flag of field to status. field_status() returns the status of field.


set_max_field() sets a maximum growth on a dynamic field, or if max=0
turns off any maximum growth.

RETURN VALUES


field_buffer() returns NULL on error.


field_status() returns TRUE or FALSE.


set_field_buffer(), set_field_status(), and set_max_field() return one of
the following:

E_OK
The function returned successfully.


E_SYSTEM_ERROR
System error


E_BAD_ARGUMENT
An argument is incorrect.


ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO


curses(3CURSES), forms(3CURSES), attributes(7)

NOTES


The header <form.h> automatically includes the headers <eti.h> and
<curses.h>.


illumos December 31, 1996 FORM_FIELD_BUFFER(3CURSES)