putchar, putwchar

Schreiben Sie stdout ein Zeichen.

int putchar(  int c ); wint_t putwchar(  wchar_t c );

Parameter

• c
  Geschrieben werden Zeichen.

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, generieren ein NULL-Zeiger für stream, diese Funktionen eine ungültige Parameterausnahme, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, geben sie EOF oder WEOF und Menge errno zu EINVAL zurück.

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.

Die Versionen mit dem _nolock Suffix sind identisch, allerdings werden nicht von der Fehler durch andere Threads geschützt.Sie sind möglicherweise schneller, da sie nicht der Mehraufwand für andere Threads heraus sperren verursachen.Verwenden Sie diese Funktionen nur in threadsichere Kontexten wie Singlethreadanwendung Anwendungen oder, wo die aufrufende Handles des Bereichs bereits Isolation erlauben.

Zuordnung generische Textroutinen

Anforderungen

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_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

.NET Framework-Entsprechung

• System::IO::StreamWriter::Write

• System::Console::Write

Siehe auch

Referenz

Stream E/A

fputc, fputwc

getc, getwc