Layout Service Library Functions         mcreatelayout(3LAYOUT)



NAME
     mcreatelayout - initialize a layout object

SYNOPSIS
     cc [ flag... ] file... -llayout [ library... ]
     #include 



     LayoutObject mcreatelayout(const AttrObject attrobj,
           const char*modifier);


DESCRIPTION
     The mcreatelayout() function creates a LayoutObject  asso-
     ciated with the locale identified by attrobj.


     The LayoutObject is an opaque object containing all the data
     and  methods  necessary  to perform the layout operations on
     context-dependent or directional characters  of  the  locale
     identified  by  the attrobj. The memory for the LayoutObject
     is allocated by mcreatelayout(). The LayoutObject  created
     has  default  layout values. If the modifier argument is not
     NUL, the layout values specified by the modifier  overwrite
     the  default  layout  values  associated  with  the  locale.
     Internal states  maintained  by  the  layout  transformation
     function  across  transformations  are  set to their initial
     values.


     The attrobj argument is or may be an amalgam of many  opaque
     objects.  A locale object is just one example of the type of
     object that can be attached  to  an  attribute  object.  The
     attrobj argument specifies a name that is usually associated
     with a locale category. If attrobj is NUL, the created Lay-
     outObject  is  associated  with the current locale as set by
     the setlocale(3C) function.


     The modifier argument announces a set of layout values  when
     the LayoutObject is created.

RETURN VALUES
     Upon successful completion, the  mcreatelayout()  function
     returns  a  LayoutObject  for  use  in  subsequent  calls to
     m*layout()  functions.  Otherwise  the   mcreatelayout()
     function returns (LayoutObject) 0 and sets errno to indicate
     the error.

ERORS




SunOS 5.11           Last change: 7 Aug 2006                    1






Layout Service Library Functions         mcreatelayout(3LAYOUT)



     The mcreatelayout() function may fail if:

     EBADF     The attribute object  is  invalid  or  the  locale
               asssociated  with  the  attribute  object  is  not
               available.


     EINVAL    The modifier string has a syntax error or it  con-
               tains unknown layout values.


     EMFILE    There are {OPENMAX}  file  descriptors  currently
               open in the calling process.


     ENOMEM    Insufficient storage space is available.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     setlocale(3C), attributes(5), standards(5)




















SunOS 5.11           Last change: 7 Aug 2006                    2