opensolaris man page for wctob

wctob(3C)						   Standard C Library Functions 						 wctob(3C)

NAME
       wctob - wide-character to single-byte conversion

SYNOPSIS
       #include <stdio.h>
       #include <wchar.h>

       int wctob(wint_t c);

DESCRIPTION
       The wctob() function determines whether c corresponds to a member of the extended character set whose  character representation is a single
       byte when in the initial shift state.

       The behavior of this function is affected by the LC_CTYPE category of the current locale.  See environ(5)

RETURN VALUES
       The wctob() function returns EOF if c does not correspond to a character with length one in the initial shift state.  Otherwise, it returns
       the single-byte representation of that character.

ERRORS
       No errors are defined.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe with exceptions	   |
       +-----------------------------+-----------------------------+

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

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

SunOS 5.11							    14 Aug 2002 							 wctob(3C)