1form_field_buffer(3CURSES) Curses Library Functions form_field_buffer(3CURSES)
2
3
4

NAME

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

SYNOPSIS

10       cc [ flag... ] file... -lform  -lcurses  [ library... ]
11       #include <form.h>
12
13
14
15       int set_field_buffer(FIELD *field, int buf, char *value);
16
17
18       char *field_buffer(FIELD *field, int buf);
19
20
21       int set_field_status(FIELD *field, int status);
22
23
24       int field_status(FIELD *field);
25
26
27       int set_max_field(FIELD *field, int max);
28
29

DESCRIPTION

31       set_field_buffer() sets buffer buf of field to value. Buffer  0  stores
32       the  displayed contents of the field. Buffers other than 0 are applica‐
33       tion specific and not used by the forms  library  routines.  field_buf‐
34       fer() returns the value of field buffer buf.
35
36
37       Every field has an associated status flag that is set whenever the con‐
38       tents of field buffer 0 changes.  set_field_status()  sets  the  status
39       flag of field to status. field_status() returns the status of field.
40
41
42       set_max_field()  sets  a maximum growth on a dynamic field, or if max=0
43       turns off any maximum growth.
44

RETURN VALUES

46       field_buffer() returns NULL on error.
47
48
49       field_status() returns TRUE or FALSE.
50
51
52       set_field_buffer(), set_field_status(), and set_max_field() return  one
53       of the following:
54
55       E_OK              Thefunction returned successfully.
56
57
58       E_SYSTEM_ERROR    System error
59
60
61       E_BAD_ARGUMENT    An argument is incorrect.
62
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │MT-Level                     │Unsafe                       │
74       └─────────────────────────────┴─────────────────────────────┘
75

SEE ALSO

77       curses(3CURSES), forms(3CURSES), attributes(5)
78

NOTES

80       The  header  <form.h>  automatically  includes the headers  <eti.h> and
81       <curses.h>.
82
83
84
85SunOS 5.11                        31 Dec 1996       form_field_buffer(3CURSES)