putws(3C)

DESCRIPTION

putws() writes a character string corresponding to the null-terminated wide-character string pointed to by ws followed by a new-line character, to the standard output stream stdout.

fputws() writes a character string corresponding to the null-terminated wide-character string pointed to by ws to the named output stream, but does not append a new-line character or a terminating null character.

Neither function writes a terminating null character.

The definition for these functions, the type wchar_t and the value WEOF are provided in the <wchar.h> header.

APPLICATION USAGE

After putws() or fputws() is applied to a stream, the stream becomes wide-oriented (see orientation(5)).

EXTERNAL INFLUENCES

RETURN VALUE

Upon successful completion, putws(), putws_unlocked(), fputws(), and fputws_unlocked() return a non-negative number. Otherwise they return WEOF, set the error indicator for the stream, and set errno to indicate the error.

ERRORS

putws(), putws_unlocked(), fputws(), and fputws_unlocked() fail if either the stream is unbuffered, or stream's buffer needed to be flushed causing an underlying write() call to be invoked, and:

Additional errno values may be set by the underlying write() function (see write(2)).

WARNINGS

putws_unlocked() and fputws_unlocked() are obsolescent interfaces supported only for compatibility with existing DCE applications. New multithreaded applications should use putws() and fputws().

AUTHOR

putws() and fputws() were developed by OSF and HP.

SEE ALSO

ferror(3S), flockfile(3S), fopen(3S), fread(3S), printf(3S), putwc(3C), orientation(5), thread_safety(5).

STANDARDS CONFORMANCE

fputws(): XPG4