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  2015-08-08 "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 ATTRIBUTES
  61 For an explanation of the terms used in this section, see
  62 .BR attributes (7).
  63 .TS
  64 allbox;
  65 lb lb lb
  66 l l l.
  67 Interface       Attribute       Value
  68 T{
  69 .BR putwchar ()
  70 T}      Thread safety   MT-Safe
  71 .TE
  72 .SH CONFORMING TO
  73 POSIX.1-2001, POSIX.1-2008, C99.
  74 .SH NOTES
  75 The behavior of
  76 .BR putwchar ()
  77 depends on the
  78 .B LC_CTYPE
  79 category of the
  80 current locale.
  81 .PP
  82 It is reasonable to expect that
  83 .BR putwchar ()
  84 will actually write
  85 the multibyte sequence corresponding to the wide character
  86 .IR wc .
  87 .SH SEE ALSO
  88 .BR fputwc (3),
  89 .BR unlocked_stdio (3)