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 zur FILE -Struktur.

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 putwcEOFWEOF. Verwenden Oder feof überprüfen Sie ferror für alle vier Routinen einen Fehler oder ein Dateiende. Wenn ein NULL-Zeiger übergeben streamwird, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die Ausführung fortgesetzt werden darf, werden diese Funktionen zurückgegeben EOF oder festgelegt und auf EINVALerrnoWEOF.

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. putcund 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. 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 _nolock Suffix sind identisch, mit der Ausnahme, dass sie nicht vor Störungen durch andere Threads geschützt sind. Weitere Informationen finden Sie unter _putc_nolock, _putwc_nolock.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

TCHAR.H-Routine	_UNICODE und _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 Universelle Windows-Plattform -Apps (UWP) nicht unterstützt. Die Standardstreamhandles, die der Konsole zugeordnet sind, stdinstdoutund stderrmüssen umgeleitet werden, bevor C-Laufzeitfunktionen sie in UWP-Apps verwenden können. Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Bibliotheken

Alle Versionen der 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

Siehe auch

Stream-E/A
fputc, fputwc
getc, getwc