putchar, putwchar
Schreibt ein Zeichen in stdout.
Syntax
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 End-of-File-Bedingung anzugeben, putc und zurückgeben ; putchar und putwchar zurückgeben putwc EOFWEOF. Verwenden Oder feof überprüfen Sie ferror für alle vier Routinen einen Fehler oder ein Dateiende. Wenn ein NULL-Zeiger für streamdiese Funktionen übergeben wird, generieren diese Funktionen eine ungültige Parameter exception, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, geben sie zurück EOF oder WEOF, und legen sie auf errno .EINVAL
Weitere Informationen zu Rückgabecodes finden Sie unter , , _doserrno, _sys_errlistund _sys_nerr.errno
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 identisch mit putc( c, stdout ). Wenn ein Lesefehler auftritt, wird für jede Routine die Fehleranzeige für den Stream festgelegt. putc und putchar ähneln fputc bzw _fputchar. werden sowohl als Funktionen als auch als Makros implementiert (siehe Empfehlungen für die Auswahl 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.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Mapping generischer Textroutinen
| TCHAR.H-Routine | _UNICODE und _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 UWP-Apps (Universelle Windows-Plattform) nicht unterstützt. Die mit der Konsole verknüpften Standardstreamhandles stdin, stdout und stderr müssen umgeleitet werden, bevor sie von C-Laufzeitfunktionen in UWP-Apps verwendet werden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Libraries
Alle Versionen der 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 );
}
Output
This is the line of output