Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

Guardian Native C Library Calls (n - r) putws(3)
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 native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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 to a file that exceeds the process’s file size limit or
the maximum file size.
[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.
527192-005 Hewlett-Packard Company 5−43