form_field_buffer(3X)          DG/UX R4.11MU05         form_field_buffer(3X)


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

SYNOPSIS
       #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 VALUE
       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.

NOTES
       The  header  file  <form.h>  automatically  includes the header files
       <eti.h> and <curses.h>.

SEE ALSO
       curses(3X), forms(3X).


Licensed material--property of copyright holder(s)