diff options
Diffstat (limited to 'man3/puts.3')
-rw-r--r-- | man3/puts.3 | 114 |
1 files changed, 114 insertions, 0 deletions
diff --git a/man3/puts.3 b/man3/puts.3 new file mode 100644 index 000000000..8f33ef26c --- /dev/null +++ b/man3/puts.3 @@ -0,0 +1,114 @@ +.\" (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" License. +.\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu) +.TH PUTS 3 1993-04-04 "GNU" "Linux Programmer's Manual" +.SH NAME +fputc, fputs, putc, putchar, puts \- output of characters and strings +.SH SYNOPSIS +.nf +.B #include <stdio.h> +.sp +.BI "int fputc(int " c ", FILE *" stream ); +.nl +.BI "int fputs(const char *" "s" ", FILE *" "stream" ); +.nl +.BI "int putc(int " c ", FILE *" stream ); +.nl +.BI "int putchar(int " c ); +.nl +.BI "int puts(const char *" "s" ); +.SH DESCRIPTION +.B fputc() +writes the character +.IR c , +cast to an +.BR "unsigned char" , +to +.IR stream . +.PP +.B fputs() +writes the string +.I s +to +.IR stream , +without its trailing +.BR '\e0' . +.PP +.B putc() +is equivalent to +.B fputc() +except that it may be implemented as a macro which evaluates +.I stream +more than once. +.PP +.BI "putchar(" c ); +is equivalent to +.BI "putc(" c , stdout ). +.PP +.BR puts() +writes the string +.I s +and a trailing newline +to +.IR stdout . +.PP +Calls to the functions described here can be mixed with each other and with +calls to other output functions from the +.B stdio +library for the same output stream. +.PP +For non-locking counterparts, see +.BR unlocked_stdio (3). +.SH "RETURN VALUE" +.BR fputc() , " putc() " and " putchar()" +return the character written as an +.B unsigned char +cast to an +.B int +or +.B EOF +on error. +.PP +.BR puts() " and " fputs() +return a non-negative number on success, or +.B EOF +on error. +.PP +.SH "CONFORMING TO" +ANSI - C, POSIX.1 +.SH BUGS +It is not advisable to mix calls to output functions from the +.B stdio +library with low - level calls to +.B write() +for the file descriptor associated with the same output stream; the results +will be undefined and very probably not what you want. +.SH "SEE ALSO" +.BR write (2), +.BR ferror (3), +.BR fopen (3), +.BR fseek (3), +.BR fwrite (3), +.BR gets (3), +.BR scanf (3), +.BR unlocked_stdio (3) |