HP-UX Reference (11i v2 04/09) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

261

262

263

264

265

266

267

268

269

270

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 written.

On failure, they return the constant

WEOF, set the error indicator for the stream, and set

errno to indi-

cate 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 pro-

cess 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

neither 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

process. 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 stan-

dard 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.