putc, putwc
Schreibt ein Zeichen in einen Stream.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parameter
c
Zu schreibende Zeichen.stream
Zeiger auf die FILE-Struktur.
Rückgabewert
Gibt das geschriebene Zeichen zurück. Um einen Fehler oder eine Dateiendebedingung anzugeben, geben putc und putcharEOF zurück; putwc und putwchar geben WEOF zurück. Verwenden Sie bei allen vier Routinen ferror oder feof, um auf einen Fehler oder ein Dateiende zu prüfen. Wenn ein NULL-Zeiger für stream übergeben wird, wird der Handler für ungültige Parameter aufgerufen, wie unter Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen EOF oder WEOF zurück und stellen errno auf EINVAL ein.
Weitere Informationen zu diesen und anderen Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.
Hinweise
Die putc-Routine schreibt das einzelne Zeichen c in die aktuelle Position der stream-Ausgabe. Jede beliebige ganze Zahl kann an putc übergeben werden, aber es werden nur die unteren 8 Bits geschrieben. Die putchar-Routine ist mit putc( c**,stdout )** identisch. Wenn ein Lesefehler auftritt, wird für jede Routine die Fehleranzeige für den Stream festgelegt. putc und putchar ähneln jeweils fputc und _fputchar, werden jedoch sowohl als Funktionen als auch als Makros implementiert (siehe Auswählen zwischen Funktionen und Makros). putwc und putwchar sind jeweils Breitzeichenversionen von putc und putchar. putwc und putc verhalten sich identisch, wenn der Stream in ANSI-Modus geöffnet ist. putc unterstützt derzeit die Ausgabe in einen UNICODE-Stream nicht.
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 _putc_nolock, _putwc_nolock.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
putc |
<stdio.h> |
putwc |
<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.
Bibliotheken
Alle Versionen C-Laufzeitbibliotheken.
Beispiel
// crt_putc.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/
#include <stdio.h>
int main( void )
{
FILE *stream;
char *p, buffer[] = "This is the line of output\n";
int ch;
ch = 0;
/* Make standard out the stream and write to it. */
stream = stdout;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putc( *p, stream );
}
Ausgabe
This is the line of output