|FPUTC(3C)||Standard C Library Functions||FPUTC(3C)|
#include <stdio.h> int fputc(int c, FILE *stream);
int putc(int c, FILE *stream);
int putc_unlocked(int c, FILE *stream);
int putchar(int c);
int putchar_unlocked(int c);
int putw(int w, FILE *stream);
The st_ctime and st_mtime fields of the file will be marked for update between the successful execution of fputc() and the next successful completion of a call to fflush(3C) or fclose(3C) on the same stream or a call to exit(3C) or abort(3C).
The putc() routine behaves like fputc(), except that it is implemented as a macro. It runs faster than fputc(), but it takes up more space per invocation and its name cannot be passed as an argument to a function call.
The call putchar(c) is equivalent to putc(c, stdout). The putchar() routine is implemented as a macro.
The putc_unlocked() and putchar_unlocked() routines are variants of putc() and putchar(), respectively, that do not lock the stream. It is the caller's responsibility to acquire the stream lock before calling these routines and releasing the lock afterwards; see flockfile(3C) and stdio(3C). These routines are implemented as macros.
The putw() function writes the word (that is, type int) w to the output stream (at the position at which the file offset, if defined, is pointing). The size of a word is the size of a type int and varies from machine to machine. The putw() function neither assumes nor causes special alignment in the file.
The st_ctime and st_mtime fields of the file will be marked for update between the successful execution of putw() and the next successful completion of a call to fflush(3C) or fclose(3C) on the same stream or a call to exit(3C) or abort(3C).
Upon successful completion, putw() returns 0. Otherwise, it returns a non-zero value, sets the error indicator for the associated stream, and sets errno to indicate the error.
An unsuccessful completion will occur, for example, if the file associated with stream is not open for writing or if the output file cannot grow.
The fputc(), putc(), putc_unlocked(), putchar(), putchar_unlocked(), and putw() functions may fail if:
When the macro forms are used, putc() and putc_unlocked() evaluate the stream argument more than once. In particular, putc(c, *f++); does not work sensibly. The fputc() function should be used instead when evaluating the stream argument has side effects.
Because of possible differences in word length and byte ordering, files written using putw() are implementation-dependent, and possibly cannot be read using getw(3C) by a different application or by the same application running in a different environment.
The putw() function is inherently byte stream oriented and is not tenable in the context of either multibyte character streams or wide-character streams. Application programmers are encouraged to use one of the character-based output functions instead.
|ATTRIBUTE TYPE||ATTRIBUTE VALUE|
|Interface Stability||fputc(), putc(), putc_unlocked(), putchar(), and putchar_unlocked() are Standard.|
|MT-Level||See NOTES below.|
|March 25, 2020||OmniOS|