putchar, putwchar

Scrivere un carattere a stdout.

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

Parametri

• c
  Carattere da scrivere.

Valore restituito

Restituisce il carattere scritto.Per indicare un errore o una condizione di fine file, putc e putchar restituiscono EOF; putwc e ritorno WEOFdi putwchar.Per tutti e quattro gli routine, utilizzare ferror o feof verificare la presenza di un errore o di fine file.Se passato un puntatore null per stream, queste funzioni generato un'eccezione non valida di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, restituiscono EOF o WEOF e errno stabilito a EINVAL.

Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici di errore.

Note

La routine di putc scrive il singolo carattere c a stream di output dalla posizione corrente.Qualsiasi intero può essere passato a putc, ma solo i 8 bit più significativi vengono scritti.La routine di putchar è identica a putc(c,stdout ).Per ogni routine, se un errore di lettura caso, il contrassegno di errore per il flusso è impostato su.putc e putchar sono simili a fputc e a _fputchar, rispettivamente, ma sono implementati sia come che funzioni come macro (vedere Scelta tra le funzioni e le macro).putwc e putwchar disponibili versioni a caratteri estesi di putc e di putchar, rispettivamente.

Le versioni con il suffisso _nolock sono identiche ma non sono protette in interferenze da parte di altri thread.Risultano più veloci poiché non comportano un sovraccarico di bloccare da altri thread.Utilizzare queste funzioni solo in contesti thread-safe come applicazioni a thread singolo o dove gli chiamante di ambito già threading di isolamento.

Mapping di routine a Testo generico

Requisiti

La console non è supportata nelle applicazioni di Windows Store.L'handle standard del flusso associate alla console, stdin, stdoute stderr, devono essere reindirizzati prima di funzioni di runtime del linguaggio C possono essere utilizzate nelle applicazioni di Windows Store.Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Librerie

Tutte le versioni delle Librerie di runtime C.

Esempio

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

Equivalente .NET Framework

• System::IO::StreamWriter::Write

• System::Console::Write

Vedere anche

Riferimenti

Flusso I/O

fputc, fputwc

getc, getwc