fputc, fputwc
Schreibt ein Zeichen in einen Stream.
int fputc( int c, FILE *stream ); wint_t fputwc( wchar_t c, FILE *stream );
Parameter
c
Geschrieben werden Zeichen.stream
Zeiger auf FILE-Struktur.
Rückgabewert
Jede dieser Funktionen gibt das geschriebene Zeichen zurück.Für fputc gibt ein Rückgabewert von EOF einen Fehler an.Für fputwc gibt ein Rückgabewert von WEOF einen Fehler an.Wenn streamNULL ist, rufen diese Funktionen den ungültigen Parameterhandler auf, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, geben sie EOF und Menge errno zu EINVAL zurück.
Siehe _doserrno, errno, _sys_errlist und _sys_nerr weitere Informationen zu diesen und anderen, Fehlercodes.
Hinweise
Jede dieser Funktionen schreibt das einzelne Zeichen c zu einer Datei in der Position, die ggf. durch den Stellungsanzeiger der zugeordneten Datei angegeben wird (wenn Sie definiert sind) und die Fortschritte der Zähler.Bei fputc und fputwc wird die Datei mit stream zugeordnet . Wenn die Datei Positionierung von Anforderungen nicht unterstützt oder in anfügen Modus geöffnet wurde, wird das Zeichen am Ende des Streams angefügt.
Die beiden Funktionen verhalten sich identisch, wenn der Stream in ANSI-Modus geöffnet ist.fputc nicht unterstützt Ausgabe in einen UNICODE-Stream.
Die Versionen mit dem _nolock Suffix sind identisch, allerdings werden nicht von der Fehler durch andere Threads geschützt.Weitere Informationen finden Sie unter _fputc_nolock, _fputwc_nolock.
Routine-Besondere-Hinweise folgen.
Routine |
Hinweise |
|---|---|
fputc |
Entspricht putc, implementiert jedoch nur als Funktion, sondern als Funktion und Makro. |
fputwc |
Breitzeichen-Version von fputc.Schreibt c als Mehrbytezeichen oder Breitzeichen, je nachdem ob stream im Textmodus oder im Binärdateimodus geöffnet ist. |
Zuordnung generische 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 nicht in Windows Store-App unterstützt.Die Standardstreamhandles, die mit der Konsole, stdin, stdout und stderr zugeordnet werden, müssen umgeleitet werden, bevor sie C-Laufzeitfunktionen in Windows Store-App verwenden können.So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.
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 ) ;
}