Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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

NAME
       std::puts - std::puts

Synopsis
	  Defined in header <cstdio>
	  int puts( const char *str );

	  Writes  every	 character from	the null-terminated string str and one
       additional
	  newline character '\n' to the	output stream stdout, as if by repeat-
       edly executing
	  std::fputc.

	  The terminating null character from str is not written.

Parameters
	  str -	character string to be written

Return value
	  On success, returns a	non-negative value

	  On failure, returns EOF and sets the error indicator (see  std::fer-
       ror) on stdout.

Notes
	  The  std::puts function appends the newline character	to the output,
       while std::fputs
	  function does	not.

	  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.

	  A typical cause of failure for std::puts is running out of space  on
       the file	system,
	  when stdout is redirected to a file.

Example
       // Run this code

	#include <cstdio>

	int main()
	{
	    int	rc = std::puts("Hello World");

	    if (rc == EOF)
	       std::perror("puts()"); // POSIX requires	that errno is set
	}

Output:
	Hello World

See also
	  fputs	   writes a character string to	a file stream
		   (function)
	  printf
	  fprintf   prints  formatted  output  to  stdout,  a file stream or a
       buffer
	  sprintf  (function)
	  snprintf
	  (C++11)

http://cppreference.com		  2022.07.31			  std::puts(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::puts&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help