fputc, fputwc
Schreibt ein Zeichen in einen Stream.
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
Parameter
c
Zu schreibende Zeichen.stream
Zeiger zur FILE-Struktur.
Rückgabewert
Jede dieser Funktionen gibt das geschriebene Zeichen zurück. Bei fputc gibt ein Rückgabewert von EOF einen Fehler an. Bei fputwc gibt ein Rückgabewert von WEOF einen Fehler an. Wenn streamNULL ist, rufen diese Funktionen den Handler für ungültige Parameter auf, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, wird EOF zurückgegeben und errno auf EINVAL festgelegt.
Weitere Informationen zu diesen und anderen Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Jede dieser Funktionen schreibt das einzelne Zeichen c an der Position, die durch die dazugehörige Dateipositionsanzeige (sofern definiert) angegeben ist, in eine Datei und versetzt die Anzeige entsprechend nach vorn. Bei fputc und fputwc wird die Datei stream zugeordnet. Wenn die Datei keine Positionierungsanforderungen unterstützt oder im Append-Modus geöffnet wurde, wird das Zeichen am Ende des Streams angefügt.
Die zwei Funktionen verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. fputc unterstützt die Ausgabe in einen UNICODE-Stream augenblicklich nicht.
Die Versionen mit dem _nolock-Suffix sind identisch, allerdings sind sie nicht vor Störungen durch andere Threads geschützt. Weitere Informationen finden Sie unter _fputc_nolock, _fputwc_nolock.
Es folgen routinespezifische Hinweise.
Routine |
Hinweise |
|---|---|
fputc |
Entspricht putc, wird jedoch anstelle einer Funktion und eines Makros nur als Funktion implementiert. |
fputwc |
Breitzeichenversion von fputc. Schreibt c als Multibytezeichen oder Breitzeichen, je nachdem, ob stream im Textmodus oder im Binärdateimodus geöffnet ist. |
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
Anforderungen
Funktion |
Erforderlicher Header |
|---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> oder <wchar.h> |
Die Konsole wird in Windows Store-Apps nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles, stdin, stdout und stderr, müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in Windows Store-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr1[] = "This is a test of fputc!!\n";
char *p;
// Print line to stream using fputc.
p = strptr1;
while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;
}