diff options
Diffstat (limited to 'usr/src/man/man3c/fputc.3c')
| -rw-r--r-- | usr/src/man/man3c/fputc.3c | 14 |
1 files changed, 4 insertions, 10 deletions
diff --git a/usr/src/man/man3c/fputc.3c b/usr/src/man/man3c/fputc.3c index 11f4d8f711..2cd811282d 100644 --- a/usr/src/man/man3c/fputc.3c +++ b/usr/src/man/man3c/fputc.3c @@ -43,12 +43,11 @@ .\" Portions Copyright (c) 1992, X/Open Company Limited. All Rights Reserved. .\" Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved. .\" -.TH FPUTC 3C "May 13, 2017" +.TH FPUTC 3C "March 25, 2020" .SH NAME fputc, putc, putc_unlocked, putchar, putchar_unlocked, putw \- put a byte on a stream .SH SYNOPSIS -.LP .nf #include <stdio.h> @@ -81,7 +80,6 @@ stream .fi .SH DESCRIPTION -.LP The \fBfputc()\fR function writes the byte specified by \fIc\fR (converted to an \fBunsigned char\fR) to the output stream pointed to by \fIstream\fR, at the position indicated by the associated file-position indicator for the stream (if @@ -125,7 +123,6 @@ update between the successful execution of \fBputw()\fR and the next successful completion of a call to \fBfflush\fR(3C) or \fBfclose\fR(3C) on the same stream or a call to \fBexit\fR(3C) or \fBabort\fR(3C). .SH RETURN VALUES -.LP Upon successful completion, \fBfputc()\fR, \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR, and \fBputchar_unlocked()\fR return the value that was written. Otherwise, these functions return EOF, the error indicator for the @@ -140,7 +137,6 @@ sets \fBerrno\fR to indicate the error. An unsuccessful completion will occur, for example, if the file associated with \fIstream\fR is not open for writing or if the output file cannot grow. .SH ERRORS -.LP The \fBfputc()\fR, \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR, \fBputchar_unlocked()\fR, and \fBputw()\fR functions will fail if either the \fIstream\fR is unbuffered or the \fIstream\fR's buffer needs to be flushed, @@ -204,7 +200,9 @@ was transferred. A physical I/O error has occurred, or the process is a member of a background process group attempting to write to its controlling terminal, \fBTOSTOP\fR is set, the process is neither ignoring nor blocking \fBSIGTTOU\fR and the process -group of the process is orphaned. This error may also be returned under +group of the process is orphaned. \fIstream\fR was created by +\fBopen_wmemstream\fR(3C) and a wide-character or byte sequence buffered is +invalid in the current locale. This error may also be returned under implementation-dependent conditions. .RE @@ -252,7 +250,6 @@ capabilities of the device. .RE .SH USAGE -.LP Functions exist for the \fBputc()\fR, \fBputc_unlocked()\fR, \fBputchar()\fR, and \fBputchar_unlocked()\fR macros. To get the function form, the macro name must be undefined (for example, \fB#undef putc\fR). @@ -276,7 +273,6 @@ in the context of either multibyte character streams or wide-character streams. Application programmers are encouraged to use one of the character-based output functions instead. .SH ATTRIBUTES -.LP See \fBattributes\fR(5) for descriptions of the following attributes: .sp @@ -295,14 +291,12 @@ MT-Level See \fBNOTES\fR below. .TE .SH SEE ALSO -.LP \fBgetrlimit\fR(2), \fBulimit\fR(2) \fBwrite\fR(2), \fBIntro\fR(3), \fBabort\fR(3C), \fBexit\fR(3C), \fBfclose\fR(3C), \fBferror\fR(3C), \fBfflush\fR(3C), \fBflockfile\fR(3C), \fBprintf\fR(3C), \fBputc\fR(3C), \fBputs\fR(3C), \fBsetbuf\fR(3C), \fBstdio\fR(3C), \fBattributes\fR(5), \fBstandards\fR(5) .SH NOTES -.LP The \fBfputc()\fR, \fBputc()\fR, \fBputchar()\fR, and \fBputw()\fR routines are MT-Safe in multithreaded applications. The \fBputc_unlocked()\fR and \fBputchar_unlocked()\fR routines are unsafe in multithreaded applications. |