home | help 
std::fputs(3)		       C++ Standard Libary		   std::fputs(3)

NAME
     std::fputs - std::fputs

Synopsis
	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  out-
     put, 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 con-
     stant such as
	zero.

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

See also
	printf
	fprintf  prints formatted output to stdout, a file stream or a buffer
	sprintf  (function)
	snprintf
	(C++11)
	puts	 writes a character string to stdout
		 (function)
	fputws	 writes a wide string to a file stream
		 (function)
	fgets	 gets a character string from a file stream
		 (function)
	C documentation for
	fputs

http://cppreference.com 	   2024.06.10			   std::fputs(3)
home | help