Manual Pages for UNIX Operating System command usage for man wctomb

Standard C Library Functions                           wctomb(3C)



NAME
     wctomb - convert a wide-character code to a character

SYNOPSIS
     #include 

     int wctomb(char *s, wchar_t wchar);


DESCRIPTION
     The wctomb() function determines the number of bytes  needed
     to  represent  the  character  corresponding  to  the  wide-
     character code whose value is wchar. It stores the character
     representation (possibly multiple bytes) in the array object
     pointed to by s (if s  is  not  a  null  pointer).  At  most
     MB_CUR_MAX bytes are stored.


     A call with s as a null  pointer  causes  this  function  to
     return  0.  The behavior of this function is affected by the
     LC_CTYPE category of the current locale.

RETURN VALUES
     If s is a null pointer, wctomb() returns 0 value.  If  s  is
     not  a  null  pointer,  wctomb()  returns -1 if the value of
     wchar does not correspond to a valid character,  or  returns
     the   number   of   bytes   that  constitute  the  character
     corresponding to the value of wchar.


     In no case will the value returned be greater than the value
     of the MB_CUR_MAX macro.

ERRORS
     No errors are defined.

USAGE
     The wctomb() function can be used safely in a  multithreaded
     application, as long as setlocale(3C) is not being called to
     change the locale.

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











SunOS 5.11          Last change: 14 Aug 2002                    1






Standard C Library Functions                           wctomb(3C)



     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe with exceptions     |
    |_____________________________|_____________________________|


SEE ALSO
     mblen(3C),    mbstowcs(3C),    mbtowc(3C),    setlocale(3C),
     wcstombs(3C), attributes(5), standards(5)









































SunOS 5.11          Last change: 14 Aug 2002                    2