]>
Commit | Line | Data |
---|---|---|
bf5a7247 | 1 | .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de) |
fea681da | 2 | .\" |
93015253 | 3 | .\" %%%LICENSE_START(VERBATIM) |
fea681da MK |
4 | .\" Permission is granted to make and distribute verbatim copies of this |
5 | .\" manual provided the copyright notice and this permission notice are | |
6 | .\" preserved on all copies. | |
7 | .\" | |
8 | .\" Permission is granted to copy and distribute modified versions of this | |
9 | .\" manual under the conditions for verbatim copying, provided that the | |
10 | .\" entire resulting derived work is distributed under the terms of a | |
11 | .\" permission notice identical to this one. | |
c13182ef | 12 | .\" |
fea681da MK |
13 | .\" Since the Linux kernel and libraries are constantly changing, this |
14 | .\" manual page may be incorrect or out-of-date. The author(s) assume no | |
15 | .\" responsibility for errors or omissions, or for damages resulting from | |
16 | .\" the use of the information contained herein. The author(s) may not | |
17 | .\" have taken the same level of care in the production of this manual, | |
18 | .\" which is licensed free of charge, as they might when working | |
19 | .\" professionally. | |
c13182ef | 20 | .\" |
fea681da MK |
21 | .\" Formatted or processed versions of this manual, if unaccompanied by |
22 | .\" the source, must acknowledge the copyright and authors of this work. | |
4b72fb64 | 23 | .\" %%%LICENSE_END |
c08df37a | 24 | .\" |
fea681da | 25 | .\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu) |
09b8afdc | 26 | .TH PUTS 3 2018-04-30 "GNU" "Linux Programmer's Manual" |
fea681da MK |
27 | .SH NAME |
28 | fputc, fputs, putc, putchar, puts \- output of characters and strings | |
29 | .SH SYNOPSIS | |
30 | .nf | |
31 | .B #include <stdio.h> | |
68e4db0a | 32 | .PP |
fea681da | 33 | .BI "int fputc(int " c ", FILE *" stream ); |
dbfe9c70 | 34 | .PP |
fea681da | 35 | .BI "int fputs(const char *" "s" ", FILE *" "stream" ); |
dbfe9c70 | 36 | .PP |
fea681da | 37 | .BI "int putc(int " c ", FILE *" stream ); |
dbfe9c70 | 38 | .PP |
fea681da | 39 | .BI "int putchar(int " c ); |
dbfe9c70 | 40 | .PP |
fea681da | 41 | .BI "int puts(const char *" "s" ); |
5895e7eb | 42 | .fi |
fea681da | 43 | .SH DESCRIPTION |
63aa9df0 | 44 | .BR fputc () |
fea681da MK |
45 | writes the character |
46 | .IR c , | |
47 | cast to an | |
9ff08aad | 48 | .IR "unsigned char" , |
fea681da MK |
49 | to |
50 | .IR stream . | |
51 | .PP | |
63aa9df0 | 52 | .BR fputs () |
fea681da MK |
53 | writes the string |
54 | .I s | |
55 | to | |
56 | .IR stream , | |
31a6818e | 57 | without its terminating null byte (\(aq\e0\(aq). |
fea681da | 58 | .PP |
63aa9df0 | 59 | .BR putc () |
fea681da | 60 | is equivalent to |
63aa9df0 | 61 | .BR fputc () |
fea681da MK |
62 | except that it may be implemented as a macro which evaluates |
63 | .I stream | |
64 | more than once. | |
65 | .PP | |
9a2b1eca | 66 | .BI "putchar(" c ) |
fea681da | 67 | is equivalent to |
724127aa | 68 | .BI "putc(" c ", " stdout ) \fR. |
fea681da | 69 | .PP |
63aa9df0 | 70 | .BR puts () |
fea681da MK |
71 | writes the string |
72 | .I s | |
73 | and a trailing newline | |
74 | to | |
75 | .IR stdout . | |
76 | .PP | |
77 | Calls to the functions described here can be mixed with each other and with | |
78 | calls to other output functions from the | |
f19a0f03 | 79 | .I stdio |
fea681da MK |
80 | library for the same output stream. |
81 | .PP | |
24b74457 | 82 | For nonlocking counterparts, see |
fea681da | 83 | .BR unlocked_stdio (3). |
47297adb | 84 | .SH RETURN VALUE |
c13182ef MK |
85 | .BR fputc (), |
86 | .BR putc () | |
e1d6264d MK |
87 | and |
88 | .BR putchar () | |
fea681da | 89 | return the character written as an |
9ff08aad | 90 | .I unsigned char |
fea681da | 91 | cast to an |
9ff08aad | 92 | .I int |
fea681da MK |
93 | or |
94 | .B EOF | |
95 | on error. | |
96 | .PP | |
c13182ef MK |
97 | .BR puts () |
98 | and | |
e1d6264d | 99 | .BR fputs () |
2fda57bd | 100 | return a nonnegative number on success, or |
fea681da MK |
101 | .B EOF |
102 | on error. | |
8fd30620 PH |
103 | .SH ATTRIBUTES |
104 | For an explanation of the terms used in this section, see | |
105 | .BR attributes (7). | |
106 | .TS | |
107 | allbox; | |
108 | lbw25 lb lb | |
109 | l l l. | |
110 | Interface Attribute Value | |
111 | T{ | |
112 | .BR fputc (), | |
113 | .BR fputs (), | |
114 | .BR putc (), | |
115 | .BR putchar (), | |
116 | .BR puts () | |
117 | T} Thread safety MT-Safe | |
118 | .TE | |
47297adb | 119 | .SH CONFORMING TO |
2d68b494 | 120 | POSIX.1-2001, POSIX.1-2008, C89, C99. |
fea681da MK |
121 | .SH BUGS |
122 | It is not advisable to mix calls to output functions from the | |
f19a0f03 | 123 | .I stdio |
4d9b6984 | 124 | library with low-level calls to |
91fe9d5c | 125 | .BR write (2) |
fea681da MK |
126 | for the file descriptor associated with the same output stream; the results |
127 | will be undefined and very probably not what you want. | |
47297adb | 128 | .SH SEE ALSO |
fea681da MK |
129 | .BR write (2), |
130 | .BR ferror (3), | |
5aecfe90 | 131 | .BR fgets (3), |
fea681da | 132 | .BR fopen (3), |
1709027c MK |
133 | .BR fputwc (3), |
134 | .BR fputws (3), | |
fea681da MK |
135 | .BR fseek (3), |
136 | .BR fwrite (3), | |
1709027c | 137 | .BR putwchar (3), |
fea681da MK |
138 | .BR scanf (3), |
139 | .BR unlocked_stdio (3) |