wctob(3) [netbsd man page]

WCTOB(3)						   BSD Library Functions Manual 						  WCTOB(3)

NAME

     wctob -- convert a wide character to a single byte character

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <wchar.h>

     int
     wctob(wint_t wc);

DESCRIPTION

     The wctob() function converts a wide character wc to a corresponding single byte character in the initial shift state of the current locale.

     The behaviour of wctob() is affected by the LC_CTYPE category of the current locale.

RETURN VALUES

     The wctob() function returns:

     EOF	   If wc is WEOF or if wc does not correspond to a valid single byte character representation.

     (otherwise)   A single byte character corresponding to wc.

ERRORS

     No errors are defined.

SEE ALSO

     btowc(3), setlocale(3), wcrtomb(3)

STANDARDS

     The wctob() function conforms to ISO/IEC 9899/AMD1:1995 (``ISO C90, Amendment 1'').

BSD
								   March 3, 2003							       BSD

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)