std::fputs
From cppreference.com
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
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
File access
Direct input/output
Unformatted input/output
Formatted input
(C++11)(C++11)(C++11)
(C++11)(C++11)(C++11)
Formatted output
(C++11)
(C++11)
File positioning
Error handling
Operations on files
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 documentation for fputs