The fputws() function is same as executing fputc() repeatedly.
It is defined in <cwchar> header file.
fputws() prototype
int fputws( const wchar_t* str, FILE* stream );
The fputws() function writes all the character stored in the wide string str to the output file stream except the terminating null wide character.
fputws() Parameters
- str: Pointer to an wide character array that stores the wide string to be written.
- stream: The output file stream to write the characters.
fputws() Return value
- On success, the fputws() function returns a nonnegative value.
- On failure it returns EOF and sets the error indicator on stream.
Example: How fputws() function works?
#include <cwchar>
#include <cstdio>
#include <clocale>
int main()
{
setlocale(LC_ALL, "en_US.UTF-8");
wchar_t line[] = L"C++ ċăn haʼnđle tĥeșë veɍƴ ŵeįrd čhāråcŧerƨ";
fputws(line, stdout);
return 0;
}
When you run the program, the output will be:
C++ ċăn haʼnđle tĥeșë veɍƴ ŵeįrd čhāråcŧerƨ
