fputc, fputwc

Schreibt ein Zeichen in einen Stream.

Syntax

int fputc(
   int c,
   FILE *stream
);
wint_t fputwc(
   wchar_t c,
   FILE *stream
);

Parameter

c
Zu schreibende Zeichen.

Stream
Zeiger auf die FILE-Struktur.

Rückgabewert

Jede dieser Funktionen gibt das geschriebene Zeichen zurück. Für fputcgibt der Rückgabewert EOF einen Fehler an. Bei fputwcgibt der Rückgabewert WEOF einen Fehler an. Wenn streamNULList, rufen diese Funktionen den Handler für ungültige Parameter auf, wie unter Parametervalidierungbeschrieben. Wenn die weitere Ausführung zugelassen wird, geben sie EOF zurück und legen errno auf EINVALfest.

Weitere Informationen zu diesen und anderen Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Bemerkungen

Jede dieser Funktionen schreibt das einzelne Zeichen c an der durch den zugeordneten Dateipositionsindikator angegebenen Position (sofern definiert) in eine Datei und erweitert den Indikator nach Bedarf. Im Fall von fputc und fputwcist die Datei streamzugeordnet. 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 derzeit keine Ausgabe in einen UNICODE-Stream.

Die Versionen mit dem Suffix _nolock 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 zurückgegebener Wert Bemerkungen
fputc Entspricht putc, wird aber nur als Funktion und nicht als Funktion und Makro implementiert.
fputwc Breitzeichenversion von fputc. Schreibt c als Multibyte- oder Breitzeichen, je nach dem, ob der Stream im Text- oder Binärmodus geöffnet ist.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dies ändern, erfahren Sie unter Globaler Status in der CRT.

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 UWP-Apps (Universal Windows Platform) nicht unterstützt. Die Standardstreamhandles, die der Konsole ——stdoutund stderrzugeordnet sind, müssen umgeleitet werden, bevor C-Laufzeitfunktionen sie in UWP-Apps verwenden können. Zusätzliche Informationen zur Kompatibilität finden Sie unter Compatibility.

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 ) ;

}
This is a test of fputc!!

Weitere Informationen

Stream-E/A
fgetc, fgetwc
putc, putwc