Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

putws(3) Guardian Native C Library Calls Reference Manual
NAME
putws - Writes a wide-character string to the standard output stream
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <wchar.h>
int putws(
wchar_t *string);
PARAMETERS
string Points to a string to be written to output.
DESCRIPTION
The putws() function writes the wchar_t string pointed to by the string parameter to the stan-
dard output stream, stdout. Each wide character is converted to the equivalent multibyte charac-
ter. In all other respects, putws( ) functions like puts().
The st_ctime and st_mtime fields of the file are marked for update between the successful exe-
cution of the putws() function, and the next successful completion of a call to the fflush() or
fclose() function on the same stream, or a call to the exit() or abort() function.
RETURN VALUES
Upon successful completion, the putws() function returns the number of characters written. The
function returns EOF on an error.
ERRORS
If any of the following conditions occur, the putws() function sets errno to the corresponding
value.
[EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the
process would be delayed in the write operation.
[EBADF] The file descriptor underlying stream is not a valid file descriptor open for writ-
ing.
[EFBIG] An attempt was made to write at or beyond the file offset maximum.
[EINTR] The read operation was interrupted by a signal that was caught, and no data was
transferred.
[EIO] The implementation supports job control; the process is a member of a back-
ground process group attempting to write to its controlling terminal; TOSTOP is
set; the process is neither ignoring nor blocking SIGTTOU; and the process
group of the process is orphaned.
[ENOMEM] Insufficient storage space available.
[ENOSPC] There was no free space remaining on the device containing the file.
5−78 Hewlett-Packard Company 527192-018