WCTOMB(3)

NAME
2.47 `wctomb'--minimal wide char to multibyte converter

SYNOPSIS
     #include <stdlib.h>
     int wctomb(char *S, wchar_t WCHAR);

DESCRIPTION
When _MB_CAPABLE is not defined, this is a minimal ANSI-conforming implementation of `wctomb'. The only "wide characters" recognized are single bytes, and they are "converted" to themselves.
   When _MB_CAPABLE is defined, this routine calls `_wctomb_r' to perform the conversion, passing a state variable to allow state dependent decoding. The result is based on the locale setting which may be restricted to a defined set of locales.
   Each call to `wctomb' modifies `*S' unless S is a null pointer or _MB_CAPABLE is defined and WCHAR is invalid.

RETURNS
This implementation of `wctomb' returns `0' if S is `NULL'; it returns `-1' if _MB_CAPABLE is enabled and the wchar is not a valid multi-byte character, it returns `1' if _MB_CAPABLE is not defined or the wchar is in reality a single byte character, otherwise it returns the number of bytes in the multi-byte character.

PORTABILITY
`wctomb' is required in the ANSI C standard. However, the precise effects vary with the locale.
   `wctomb' requires no supporting OS subroutines.

SEE ALSO
wctomb is part of the library. The full documentation for is maintained as a Texinfo manual. If info and are properly installed at your site, the command

    info

will give you access to the complete manual.