Standard C Library Functions                          mbsinit(3C)



NAME
     mbsinit - determine conversion object status

SYNOPSIS
     #include 

     int mbsinit(const mbstatet *ps);


DESCRIPTION
     If ps is not a null pointer, the mbsinit()  function  deter-
     mines  whether the object pointed to by ps describes an ini-
     tial conversion state.

RETURN VALUES
     The mbsinit() function returns non-zero if   ps  is  a  null
     pointer,  or  if  the pointed-to object describes an initial
     conversion state; otherwise, it returns 0.


     If an mbstatet object is altered by any  of  the  functions
     described  as  "restartable",  and  is then used with a dif-
     ferent character sequence, or in the other conversion direc-
     tion,  or with a different LCTYPE category setting than on
     earlier function calls,  the  behavior  is  undefined.   See
     environ(5).

ERORS
     No errors are defined.

USAGE
     The mbstatet object is used to describe the current conver-
     sion  state  from a particular character sequence to a wide-
     character sequence (or vice versa) under the rules of a par-
     ticular  setting  of  the  LCTYPE  category of the current
     locale.


     The initial conversion state corresponds, for  a  conversion
     in  either  direction,  to  the beginning of a new character
     sequence  in  the  initial  shift  state.    A   zero-valued
     mbstatet  object is at least one way to describe an initial
     conversion state.  A zero-valued  mbstatet  object  can  be
     used   to   initiate   conversion  involving  any  character
     sequence, in any LCTYPE category setting.

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






SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                          mbsinit(3C)



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


SEE ALSO
     mbrlen(3C),   mbrtowc(3C),   mbsrtowcs(3C),   setlocale(3C),
     wcrtomb(3C), wcsrtombs(3C), attributes(5), environ(5), stan-
     dards(5)

NOTES
     The mbsinit() function can be used safely  in  multithreaded
     applications,  as  long as setlocale(3C) is not being called
     to change the locale.





































SunOS 5.11          Last change: 24 Jul 2002                    2