From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/io%2Ffputs.html | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 devdocs/c/io%2Ffputs.html (limited to 'devdocs/c/io%2Ffputs.html') diff --git a/devdocs/c/io%2Ffputs.html b/devdocs/c/io%2Ffputs.html new file mode 100644 index 00000000..99726ec7 --- /dev/null +++ b/devdocs/c/io%2Ffputs.html @@ -0,0 +1,38 @@ +

fputs

Defined in header <stdio.h> 
int fputs( const char          *str, FILE          *stream );
+		 (until C99) 
int fputs( const char *restrict str, FILE *restrict stream );
+		 (since C99)

Writes every character from the null-terminated string str to the output stream stream, as if by repeatedly executing 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 ferror()) on stream.

+

Notes

The related function puts appends a newline character to the output, while 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 <stdio.h>
+ 
+int main(void)
+{
+    int rc = fputs("Hello World", stdout);
+ 
+    if (rc == EOF)
+       perror("fputs()"); // POSIX requires that errno is set
+}

Output:

+
Hello World

References

See also

+ + + +
+
(C99)(C11)(C11)(C11)(C11)
 prints formatted output to stdout, a file stream or a buffer
(function)
writes a character string to stdout
(function)
gets a character string from a file stream
(function)
C++ documentation for fputs
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/io/fputs +

+
-- cgit v1.2.3