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

NAME
     std::fputws - std::fputws

Synopsis
	Defined in header <cwchar>
	int fputws( const wchar_t* str, std::FILE* stream );

	Writes	every wide character from the null-terminated wide string str to
     the output
	stream stream, as if by repeatedly executing std::fputwc.

	The terminating null wide character from str is not written.

Parameters
	str    - null-terminated wide 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.

Example
     // Run this code

      #include <clocale>
      #include <cstdio>
      #include <cwchar>

      int main()
      {
	  std::setlocale(LC_ALL, "en_US.utf8");
	  int rc = std::fputws(L"a3/4!a1/4a?aaaa", stdout);

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

Possible output:
      a3/4!a1/4a?aaaa

See also
	fputs	 writes a character string to a file stream
		 (function)
	wprintf  prints formatted wide character output to stdout, a file stream
     or a buffer
	fwprintf (function)
	swprintf
	fputws	 writes a wide string to a file stream
		 (function)
	fgetws	 gets a wide string from a file stream
		 (function)
	C documentation for
	fputws

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