summaryrefslogtreecommitdiff
path: root/newlib/libc/stdlib/wctomb.c
diff options
context:
space:
mode:
Diffstat (limited to 'newlib/libc/stdlib/wctomb.c')
-rw-r--r--newlib/libc/stdlib/wctomb.c69
1 files changed, 69 insertions, 0 deletions
diff --git a/newlib/libc/stdlib/wctomb.c b/newlib/libc/stdlib/wctomb.c
new file mode 100644
index 00000000000..a6812508f27
--- /dev/null
+++ b/newlib/libc/stdlib/wctomb.c
@@ -0,0 +1,69 @@
+/*
+FUNCTION
+<<wctomb>>---minimal wide char to multibyte converter
+
+INDEX
+ wctomb
+
+ANSI_SYNOPSIS
+ #include <stdlib.h>
+ int wctomb(char *<[s]>, wchar_t <[wchar]>);
+
+TRAD_SYNOPSIS
+ #include <stdlib.h>
+ int wctomb(<[s]>, <[wchar]>)
+ 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.
+*/
+
+#ifndef _REENT_ONLY
+
+#include <stdlib.h>
+
+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 */