fputws

int fputws( const wchar_t *str, FILE *stream );

int fputws( const wchar_t * restrict str, FILE * restrict stream );

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

The terminating null wide character from str is not written.

Parameters

Return value

On success, returns a non-negative value.

On failure, returns EOF and sets the error indicator (see ferror) on stream.

Example

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    int rc = fputws(L"御休みなさい", stdout);
 
    if (rc == EOF)
       perror("fputws()"); // POSIX requires that errno is set
}

御休みなさい

References

• C11 standard (ISO/IEC 9899:2011):
• 7.29.3.4 The fputws function (p: 423)
• C99 standard (ISO/IEC 9899:1999):
• 7.24.3.4 The fputws function (p: 368)

See also