Manpages - fputws.3

Table of Contents

NAME

fputws - write a wide-character string to a FILE stream

SYNOPSIS

  #include <wchar.h>

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

DESCRIPTION

The *fputws*() function is the wide-character equivalent of the *fputs*(3) function. It writes the wide-character string starting at ws, up to but not including the terminating null wide character (L’\0’), to stream.

For a nonlocking counterpart, see *unlocked_stdio*(3).

RETURN VALUE

The *fputws*() function returns a nonnegative integer if the operation was successful, or -1 to indicate an error.

ATTRIBUTES

For an explanation of the terms used in this section, see *attributes*(7).

Interface Attribute Value
*fputws*() Thread safety MT-Safe

CONFORMING TO

POSIX.1-2001, POSIX.1-2008, C99.

NOTES

The behavior of fputws*() depends on the *LC_CTYPE category of the current locale.

In the absence of additional information passed to the *fopen*(3) call, it is reasonable to expect that *fputws*() will actually write the multibyte string corresponding to the wide-character string ws.

SEE ALSO

*fputwc*(3), *unlocked_stdio*(3)

COLOPHON

This page is part of release 5.13 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

Author: dt

Created: 2022-02-20 Sun 15:38