putc, putwc

Schreibt ein Zeichen in einen Stream.

Syntax

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 undputwchar gebenWEOF 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 legen errno aufEINVAL fest.

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

Bemerkungen

Die putc-Routine schreibt das einzelne Zeichen c an der aktuellen Position in den Ausgabestream. Jede ganze Zahl kann an putc übergeben werden, aber nur die unteren 8 Bits werden 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 jedoch sowohl als Funktionen als auch als Makros implementiert (siehe Auswählen zwischen Funktionen und Makros). putwc undputwchar sind Breitzeichenversionen von putc bzw. putchar. putwc undputc verhalten sich identisch, wenn der Stream im ANSI-Modus geöffnet ist. putc unterstützt derzeit keine Ausgabe in einem 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 _putc_nolock, _putwc_nolock.

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
_puttc putc putc putwc

Anforderungen

-Routine zurückgegebener Wert Erforderlicher Header
putc <stdio.h>
putwc <stdio.h> oder <wchar.h>

Die -Konsole wird in Universelle Windows-Plattform -Apps (UWP) nicht unterstützt. Die Standardstreamhandles, die der Konsole , stdin, stdout und stderr zugeordnet 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.

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

Output

This is the line of output

Siehe auch

Stream-E/A
fputc, fputwc
getc, getwc