2 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu)
7 .TH puts 3 (date) "Linux man-pages (unreleased)"
9 fputc, fputs, putc, putchar, puts \- output of characters and strings
12 .RI ( libc ", " \-lc )
17 .BI "int fputc(int " c ", FILE *" stream );
18 .BI "int putc(int " c ", FILE *" stream );
19 .BI "int putchar(int " c );
21 .BI "int fputs(const char *restrict " s ", FILE *restrict " stream );
22 .BI "int puts(const char *" s );
36 except that it may be implemented as a macro which evaluates
42 .BI "putc(" c ", " stdout ) \fR.
49 without its terminating null byte (\[aq]\e0\[aq]).
54 and a trailing newline
58 Calls to the functions described here can be mixed with each other and with
59 calls to other output functions from the
61 library for the same output stream.
63 For nonlocking counterparts, see
64 .BR unlocked_stdio (3).
70 return the character written as an
81 return a nonnegative number on success, or
85 For an explanation of the terms used in this section, see
93 Interface Attribute Value
100 T} Thread safety MT-Safe
106 POSIX.1-2001, POSIX.1-2008, C99.
108 It is not advisable to mix calls to output functions from the
110 library with low-level calls to
112 for the file descriptor associated with the same output stream; the results
113 will be undefined and very probably not what you want.
125 .BR unlocked_stdio (3)