/* FUNCTION <>---minimal wide char to multibyte converter INDEX wctomb ANSI_SYNOPSIS #include int wctomb(char *<[s]>, wchar_t <[wchar]>); TRAD_SYNOPSIS #include int wctomb(<[s]>, <[wchar]>) 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 int _DEFUN (wctomb, (s, wchar), char *s _AND wchar_t wchar) { #ifdef MB_CAPABLE static int state; return _wctomb_r (_REENT, s, wchar, &state); #else /* not MB_CAPABLE */ if (s == NULL) return 0; *s = (char) wchar; return 1; #endif /* not MB_CAPABLE */ } #endif /* !_REENT_ONLY */