std::fputs
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.
Parameters
str | - | null-terminated character string to be written |
stream | - | output stream |
Return value
On success, returns a non-negative value.
On failure, returns EOF
and sets the error indicator (see std::ferror
) on stream
.
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.
Example
#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
See also
(C++11) | prints formatted output to stdout , a file stream or a buffer (function) |
writes a character string to stdout (function) |
|
writes a wide string to a file stream (function) |
|
gets a character string from a file stream (function) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/io/c/fputs