1m_create_layout(3LAYOUT)Layout Service Library Functionsm_create_layout(3LAYOUT)
2
3
4

NAME

6       m_create_layout - initialize a layout object
7

SYNOPSIS

9       cc [ flag... ] file... -llayout [ library... ]
10       #include <sys/layout.h>
11
12
13
14       LayoutObject m_create_layout(const AttrObject attrobj,
15             const char*modifier);
16
17

DESCRIPTION

19       The  m_create_layout()  function creates a LayoutObject associated with
20       the locale identified by attrobj.
21
22
23       The LayoutObject is an opaque object containing all the data and  meth‐
24       ods  necessary to perform the layout operations on context-dependent or
25       directional characters of the locale identified  by  the  attrobj.  The
26       memory for the LayoutObject is allocated by m_create_layout(). The Lay‐
27       outObject created has default layout values. If the  modifier  argument
28       is  not NULL, the layout values specified by the modifier overwrite the
29       default layout values associated  with  the  locale.   Internal  states
30       maintained by the layout transformation function across transformations
31       are set to their initial values.
32
33
34       The attrobj argument is or may be an amalgam of many opaque objects.  A
35       locale  object  is  just  one example of the type of object that can be
36       attached to an attribute object. The attrobj argument specifies a  name
37       that  is usually associated with a locale category. If attrobj is NULL,
38       the created LayoutObject is associated with the current locale  as  set
39       by the setlocale(3C) function.
40
41
42       The  modifier  argument  announces a set of layout values when the Lay‐
43       outObject is created.
44

RETURN VALUES

46       Upon successful completion, the m_create_layout()  function  returns  a
47       LayoutObject  for  use  in  subsequent calls to m_*_layout() functions.
48       Otherwise the m_create_layout() function returns (LayoutObject)  0  and
49       sets errno to indicate the error.
50

ERRORS

52       The m_create_layout() function may fail if:
53
54       EBADF     The  attribute  object  is  invalid or the locale asssociated
55                 with the attribute object is not available.
56
57
58       EINVAL    The modifier string has a syntax error or it contains unknown
59                 layout values.
60
61
62       EMFILE    There  are  {OPEN_MAX} file descriptors currently open in the
63                 calling process.
64
65
66       ENOMEM    Insufficient storage space is available.
67
68

ATTRIBUTES

70       See attributes(5) for descriptions of the following attributes:
71
72
73
74
75       ┌─────────────────────────────┬─────────────────────────────┐
76       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │Interface Stability          │Standard                     │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT-Level                     │MT-Safe                      │
81       └─────────────────────────────┴─────────────────────────────┘
82

SEE ALSO

84       setlocale(3C), attributes(5), standards(5)
85
86
87
88SunOS 5.11                        7 Aug 2006          m_create_layout(3LAYOUT)
Impressum