std::fputs
From cppreference.com
C++
Input/output library
| 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) |
C-style I/O
| Types and objects | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Defined in header <cstdio>
|
|
| int fputs( const char* str, std::FILE* stream ); |
|
Writes every character from the null-terminated string str to the output stream stream, as if by repeatedly executing std::fputc.
The terminating null character from str is not written.
Contents |
[edit] Parameters
| str | - | null-terminated character string to be written |
| stream | - | output stream |
[edit] Return value
On success, returns a non-negative value
On failure, returns EOF and sets the error indicator (see std::ferror) on stream.
[edit] Notes
The related function std::puts appends a newline character to the output, while std::fputs writes the string unmodified.
Different implementations return different non-negative numbers: some return the last character written, some return the number of characters written (or INT_MAX if the string was longer than that), some simply return a non-negative constant such as zero.
[edit] Example
Run this code
#include <cstdio> int main(void) { int rc = std::fputs("Hello World", stdout); if (rc == EOF) std::perror("fputs()"); / POSIX requires that errno is set }
Output:
Hello World
[edit] See also
| (C++11) |
prints formatted output to stdout, a file stream or a buffer (function) [edit] |
| writes a character string to stdout (function) [edit] | |
| writes a wide string to a file stream (function) [edit] | |
| gets a character string from a file stream (function) [edit] | |
| C documentation for fputs
| |
