man3/putwchar.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" References consulted:
  11 .\"   GNU glibc-2 source code and manual
  12 .\"   Dinkumware C library reference http://www.dinkumware.com/
  13 .\"   OpenGroup's Single UNIX specification
  14 .\"      http://www.UNIX-systems.org/online.html
  15 .\"   ISO/IEC 9899:1999
  16 .\"
  17 .TH PUTWCHAR 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  18 .SH NAME
  19 putwchar \- write a wide character to standard output
  20 .SH SYNOPSIS
  21 .nf
  22 .B #include <wchar.h>
  23 .sp
  24 .BI "wint_t putwchar(wchar_t " wc );
  25 .fi
  26 .SH DESCRIPTION
  27 The
  28 .BR putwchar ()
  29 function is the wide-character equivalent of the
  30 .BR putchar (3)
  31 function.
  32 It writes the wide character
  33 .I wc
  34 to
  35 .IR stdout .
  36 If
  37 .I ferror(stdout)
  38 becomes true, it returns
  39 .BR WEOF .
  40 If a wide character
  41 conversion error occurs, it sets
  42 .IR errno
  43 to
  44 .B EILSEQ
  45 and returns
  46 .BR WEOF .
  47 Otherwise, it returns
  48 .IR wc .
  49 .PP
  50 For a nonlocking counterpart, see
  51 .BR unlocked_stdio (3).
  52 .SH RETURN VALUE
  53 The
  54 .BR putwchar ()
  55 function returns
  56 .I wc
  57 if no error occurred, or
  58 .B WEOF
  59 to indicate an error.
  60 .SH CONFORMING TO
  61 C99.
  62 .SH NOTES
  63 The behavior of
  64 .BR putwchar ()
  65 depends on the
  66 .B LC_CTYPE
  67 category of the
  68 current locale.
  69 .PP
  70 It is reasonable to expect that
  71 .BR putwchar ()
  72 will actually write
  73 the multibyte sequence corresponding to the wide character
  74 .IR wc .
  75 .SH SEE ALSO
  76 .BR fputwc (3),
  77 .BR unlocked_stdio (3)