fputc() -- write character to stream

SYNOPSIS

#include <stdio.h>

int fputc(int c, FILE *stream);

The fputc() function writes a byte with value c, cast as an unsigned character, to stream. After fputc() returns, the character may be held in an internal buffer either until fflush() or fclose() are executed on stream, or until the process executes exit() or abort().

PARAMETERS

c: Is the value of the byte to write to stream.
stream: Points to the output stream.

RETURN VALUES

On success, fputc() returns the value c that it wrote to stream. On failure, it returns EOF and sets errno to one of the following values:

EACCES: Another process has the file locked.
EBADF: stream is not a valid stream opened for writing.
EFBIG: The file is a regular file and an attempt was made to write at or beyond the offset maximum.
EINTR: A signal interrupted the call.
EIO: An output error occurred.
ENOMEM: Memory could not be allocated for internal buffers.
ENOSPC: An attempt is made to write to a full disk.
ENXIO: A device error occurred.
EPIPE: An attempt is made to write to a closed pipe.

CONFORMANCE

ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

If the stream is from a file opened in text mode, linefeed is translated to carriage-return linefeed on output. No such translation occurs for files opened in binary mode.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

fputc()
write character to stream

Function