compiler/stdc/wctomb.c

   1 /*
   2     Copyright © 2007-2012, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     C99 function wctomb().
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME
  11 #include <stdlib.h>
  12
  13         int wctomb(
  14
  15     SYNOPSIS
  16         char *s,
  17         wchar_t wchar)
  18
  19     FUNCTION
  20         Converts one wide char to a multi-byte char.
  21
  22     INPUTS
  23         wchar: wide char to convert
  24         s: string pointer to put the converted char into.
  25
  26     RESULT
  27         If s is not NULL it returns the number of chars written into s;
  28         zero is returned when wchar is a NULL character; -1 when the character
  29         is not valid.
  30         If s is NULL the function returns zero or non-zero when multi-byte
  31         string resp don't or do have state-dependent encodings.
  32
  33     NOTES
  34         stdc.library currently only implements "C" locale.
  35         This means that 0 is returned when s is NULL and 0, 1 or -1 when s is
  36         not NULL.
  37
  38     EXAMPLE
  39
  40     BUGS
  41
  42     SEE ALSO
  43
  44     INTERNALS
  45         Implemented as static inline function to adapt to changing wchar_t
  46         definitions
  47
  48 ******************************************************************************/
  49