putchar, putwchar
Schreibt ein Zeichen in stdout.
int putchar(
int c
);
wint_t putwchar(
wchar_t c
);
Parameter
- c
Zu schreibende Zeichen.
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, generieren diese Funktionen eine Ausnahme wegen eines ungültigen Parameters, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, wird EOF oder WEOF zurückgegeben und errno auf EINVALfestgelegt.
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.
Die Versionen mit dem Suffix _nolock sind identisch, allerdings sind sie nicht vor Störungen durch andere Threads geschützt. Sie sind möglicherweise schneller, da kein Mehraufwand zur Sperrung anderer Threads erforderlich ist. Verwenden Sie diese Funktionen nur in threadsichere Kontexten wie z. B. in Singlethreadanwendungen oder in Fällen, in denen der aufrufende Bereich die Threadisolation bereits handhabt.
Zuordnung generischer Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
putchar |
<stdio.h> |
putwchar |
<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_putchar.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;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putchar( *p );
}
Ausgabe
This is the line of output