]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/fputws.3
err.3: EXAMPLES: use EXIT_FAILURE rather than 1 as exit status
[thirdparty/man-pages.git] / man3 / fputws.3
index 6a7a60ca49827990278a5bb21a3dae0ad25c138e..98ba3d9f89ffbed5879f6497366939d839535a53 100644 (file)
@@ -1,23 +1,25 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
 .\"   Dinkumware C library reference http://www.dinkumware.com/
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
+.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
-.TH FPUTWS 3  1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH FPUTWS 3  2019-03-06 "GNU" "Linux Programmer's Manual"
 .SH NAME
 fputws \- write a wide-character string to a FILE stream
 .SH SYNOPSIS
 .nf
 .B #include <wchar.h>
-.sp
+.PP
 .BI "int fputws(const wchar_t *" ws ", FILE *" stream );
 .fi
 .SH DESCRIPTION
@@ -28,22 +30,37 @@ the
 .BR fputs (3)
 function.
 It writes the wide-character string starting at \fIws\fP, up to but
-not including the terminating L'\\0' character, to \fIstream\fP.
+not including the terminating null wide character (L\(aq\e0\(aq), to \fIstream\fP.
 .PP
-For a non-locking counterpart, see
+For a nonlocking counterpart, see
 .BR unlocked_stdio (3).
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR fputws ()
-function returns a 
-non-negative integer if the operation was
+function returns a
+nonnegative integer if the operation was
 successful, or \-1 to indicate an error.
-.SH "CONFORMING TO"
-C99, POSIX.1-2001.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR fputws ()
+T}     Thread safety   MT-Safe
+.TE
+.sp 1
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, C99.
 .SH NOTES
-The behaviour of
+The behavior of
 .BR fputws ()
-depends on the LC_CTYPE category of the
+depends on the
+.B LC_CTYPE
+category of the
 current locale.
 .PP
 In the absence of additional information passed to the
@@ -53,6 +70,6 @@ reasonable to expect that
 .BR fputws ()
 will actually write the multibyte
 string corresponding to the wide-character string \fIws\fP.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR fputwc (3),
 .BR unlocked_stdio (3)