putc, putwc
Schreiben Sie ein Zeichen in einen Stream.
int putc( int c, FILE *stream ); wint_t putwc( wchar_t c, FILE *stream );
Parameter
c
Geschrieben werden Zeichen.stream
Zeiger auf FILE-Struktur.
Rückgabewert
Gibt das geschriebene Zeichen zurück.Um Fehler oder eine Dateiende-Bedingung anzugeben, geben putc und putcharEOF zurück; putwc und putwchar Rückgabe WEOF.Damit alle vier Routinen, verwendet ferror oder feof für einen Fehler oder Dateiende überprüft.Wenn er übergeben wird, wird ein NULL-Zeiger für stream, der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, geben diese Funktionen EOF oder WEOF zurück und legen errno auf EINVAL fest.
Siehe _doserrno, errno, _sys_errlist und _sys_nerr weitere Informationen zu diesen und anderen, Fehlercodes.
Hinweise
Die putc Routine schreibt das einzelne Zeichen c zur Ausgabe stream an der aktuellen Position.Eine ganze Zahl kann zu putc übergeben werden, aber nur die unteren 8 Bits werden geschrieben.Die putchar Routine ist zu putc(c,stdout ) identisch.Für jede Routine wenn ein Lesefehler auftritt, wird der Fehler für den Stream festgelegt.putc und putchar sind zu fputc und zu _fputchar bzw. ähnlich jedoch werden als Funktionen und Makros als implementiert (siehe Auswählen zwischen Funktionen und Makros).putwc und putwchar sind Breitzeichenversionen von putc und von putchar, bzw.putwc und putc verhalten sich identisch, wenn der Stream in ANSI-Modus geöffnet ist.putc nicht unterstützt Ausgabe in einen UNICODE-Stream.
Die Versionen mit dem _nolock Suffix sind identisch, allerdings werden nicht von der Fehler durch andere Threads geschützt.Weitere Informationen finden Sie unter _putc_nolock, _putwc_nolock.
Zuordnung generische 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 nicht in Windows Store-App unterstützt.Die Standardstreamhandles, die mit der Konsole, stdin, stdout und stderr zugeordnet werden, müssen umgeleitet werden, bevor sie C-Laufzeitfunktionen in Windows Store-App verwenden können.So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.
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