/* FUNCTION <>---minimal wide char to multibyte converter INDEX wctomb SYNOPSIS #include int wctomb(char *<[s]>, wchar_t <[wchar]>); DESCRIPTION When _MB_CAPABLE is not defined, this is a minimal ANSI-conforming implementation of <>. 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 <> modifies <<*<[s]>>> unless <[s]> is a null pointer or _MB_CAPABLE is defined and <[wchar]> is invalid. RETURNS This implementation of <> returns <<0>> if <[s]> is <>; 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 <> is required in the ANSI C standard. However, the precise effects vary with the locale. <> requires no supporting OS subroutines. */ #ifndef _REENT_ONLY #include #include #include #include "local.h" int wctomb (char *s, wchar_t wchar) { #ifdef _MB_CAPABLE struct _reent *reent = _REENT; _REENT_CHECK_MISC(reent); return __WCTOMB (reent, s, wchar, &(_REENT_WCTOMB_STATE(reent))); #else /* not _MB_CAPABLE */ if (s == NULL) return 0; /* Verify that wchar is a valid single-byte character. */ if ((size_t)wchar >= 0x100) { errno = EILSEQ; return -1; } *s = (char) wchar; return 1; #endif /* not _MB_CAPABLE */ } #endif /* !_REENT_ONLY */