HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

241

242

243

244

245

246

247

248

249

250

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man3/nan.3m

________________________________________________________________

___ ___

putwc(3C) putwc(3C)

RETURN VALUE

On success, putwc(), putwc_unlocked(), fputwc(), fputwc_unlocked(), putwchar() ,

and putwchar_unlocked() each return the wide character corresponding to the value they have writ-

ten. On failure, they return the constant WEOF, set the error indicator for the stream, and set errno to

indicate the error.

ERRORS

putwc(), putwc_unlocked(), putwchar(), putwchar_unlocked(), fputwc(), and

fputwc_unlocked() fail if either the stream is unbuffered, or stream’s buffer needed to be ﬂushed

causing an underlying write() call to be invoked, and:

[EAGAIN] The O_NONBLOCK ﬂag is set for the ﬁle descriptor underlying stream and the process

would be delayed in the write operation.

[EBADF] The ﬁle descriptor underlying stream is not a valid ﬁle descriptor open for writing.

[EFBIG] An attempt was made to write to a ﬁle that exceeds the process’s ﬁle size limit or the

maximum ﬁle size (see ulimit(2)).

[EINTR] A signal was caught during the write() system call.

[EIO] A physical I/O error has occurred, or the process is in a background process group and

is attempting to write to its controlling terminal,

TOSTOP is set, the process is nei-

ther ignoring nor blocking the SIGTTOU signal, and the process group of the process

is orphaned.

[ENOSPC] There was no free space remaining on the device containing the ﬁle.

[EPIPE] An attempt is made to write to a pipe or FIFO that is not open for reading by any pro-

cess. A SIGPIPE signal is also sent to the process.

[EILSEQ] The wide character wc does not correspond to a valid character.

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

WARNINGS

Line buffering may cause confusion or malfunctioning of programs that use wide character I/O routines but

use

read() themselves to read from standard input. When a large amount of computation is done after

printing part of a line on an output terminal, it is necessary to fflush() (see fclose(3S)) the standard

output before beginning the computation.

putwc_unlocked(),

putwchar_unlocked() and fputwc_unlocked()

are obsolescent inter-

faces supported only for compatibility with existing DCE applications. New multithreaded applications

should use

putwc(), putwchar() and fputwc().

AUTHOR

putwc() was developed by OSF and HP.