| I/O manipulators | ||||
| Print functions(C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++20) | ||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
| Synchronized Output | ||||
(C++20) | ||||
| Types | ||||
| Error category interface | ||||
(C++11) | ||||
(C++11) |
| Types and objects | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <cstdio> | ||
int puts(constchar*str); | ||
Writes every character from the null-terminated stringstr and one additional newline character'\n' to the output streamstdout, as if by repeatedly executingstd::fputc.
The terminating null character fromstr is not written.
Contents |
| str | - | character string to be written |
On success, returns a non-negative value
On failure, returnsEOF and sets theerror indicator (seestd::ferror) onstdout.
Thestd::puts function appends the newline character to the output, whilestd::fputs function does not.
Different implementations return different non-negative numbers: some return the last character written, some return the number of characters written (orINT_MAX if the string was longer than that), some simply return a non-negative constant.
A typical cause of failure forstd::puts is running out of space on the file system, whenstdout is redirected to a file.
#include <cstdio> int main(){int rc= std::puts("Hello World"); if(rc==EOF)std::perror("puts()");// POSIX requires that errno is set}
Output:
Hello World
| writes a character string to a file stream (function)[edit] | |
(C++11) | prints formatted output tostdout, a file stream or a buffer (function)[edit] |
C documentation forputs | |
