m_setvalues_layout(3layout)

1m_setvalues_layout(3LAYOLUaTy)out Service Library Functimo_nssetvalues_layout(3LAYOUT)
2
3
4

NAME

6       m_setvalues_layout - set layout values of a LayoutObject
7

SYNOPSIS

9       cc [ flag... ] file... -llayout [ library... ]
10       #include <sys/layout.h>
11
12       int m_setvalues_layout(LayoutObject layout_object,
13            const LayoutValues values, int *index_returned);
14
15

DESCRIPTION

17       The  m_setvalues_layout()  function changes the layout values of a Lay‐
18       outObject.
19
20
21       The layout_object argument specifies a  LayoutObject  returned  by  the
22       m_create_layout(3LAYOUT) function.
23
24
25       The  values argument specifies the list of layout values that are to be
26       changed. The values are written into the LayoutObject  and  may  affect
27       the  behavior  of  subsequent  layout functions.  Some layout values do
28       alter internal states maintained by a LayoutObject.
29
30
31       The m_setvalues_layout() function can be implemented as  a  macro  that
32       evaluates the first argument twice.
33

RETURN VALUES

35       Upon  successful  completion, the requested layout values are set and 0
36       is returned. Otherwise −1 is returned and errno is set to indicate  the
37       error.  If  any  value  cannot  be  set,  none of the layout values are
38       changed and the (zero-based) index of the first value causing the error
39       is returned in index_returned.
40

ERRORS

42       The m_setvalues_layout() function may fail if:
43
44       EINVAL    The  layout value specified by index_returned is unknown, its
45                 value is invalid, or the layout_object argument is invalid.
46
47
48       EMFILE    There are {OPEN_MAX} file descriptors currently open  in  the
49                 calling process.
50
51

USAGE

53       Do  not  use  expressions  with  side effects such as auto-increment or
54       auto-decrement within the first argument  to  the  m_setvalues_layout()
55       function.
56

ATTRIBUTES

58       See attributes(5) for descriptions of the following attributes:
59
60
61
62
63       ┌─────────────────────────────┬─────────────────────────────┐
64       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
65       ├─────────────────────────────┼─────────────────────────────┤
66       │Interface Stability          │Standard                     │
67       ├─────────────────────────────┼─────────────────────────────┤
68       │MT-Level                     │MT-Safe                      │
69       └─────────────────────────────┴─────────────────────────────┘
70