f7143add82f22dd88de9a76cbcef06f1474598bc
[kopensolaris-gnu/glibc.git] / stdlib / wctomb.c
1 /* Copyright (C) 1991, 1992, 1995, 1996 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB.  If
16 not, write to the Free Software Foundation, Inc., 675 Mass Ave,
17 Cambridge, MA 02139, USA.  */
18
19 #include <stdlib.h>
20 #include <wchar.h>
21
22
23 extern mbstate_t __no_r_state;  /* Defined in mbtowc.c.  */
24
25 /* Convert WCHAR into its multibyte character representation,
26    putting this in S and returning its length.
27
28    Attention: this function should NEVER be intentionally used.
29    The interface is completely stupid.  The state is shared between
30    all conversion functions.  You should use instead the restartable
31    version `wcrtomb'.  */
32 int
33 wctomb (char *s, wchar_t wchar)
34 {
35   /* If S is NULL the function has to return null or not null
36      depending on the encoding having a state depending encoding or
37      not.  This is nonsense because any multibyte encoding has a
38      state.  The ISO C amendment 1 corrects this while introducing the
39      restartable functions.  We simply say here all encodings have a
40      state.  */
41   if (s == NULL)
42     return 1;
43
44   return wcrtomb (s, wchar, &__no_r_state);
45 }