putchar, putwchar
Scrive un carattere nel 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 del file, putc e putchar restituiscono EOF; putwc e putwchar restituisce WEOF. Per tutte quattro le routine, utilizzare ferror o feof per verificare la presenza di un errore o di fine del file. Se viene passato un puntatore a null per stream, queste funzioni generano un'eccezione di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni impostano EOF o WEOF e impostano errno su EINVAL.
Vedere _doserrno, errno, _sys_errlist, e _sys_nerr per ulteriori informazioni su questi, e altri, codici di errore.
Note
La routine putc scrive il singolo carattere c sullo stream di output alla posizione corrente. Qualsiasi integer può essere passato a putc, ma solo gli 8 bit più significativi vengono scritti. La routine putchar è identica a putc( c**,** stdout ). Per ogni routine, se si verifica un errore di lettura, viene impostato l'indicatore dell'errore per il flusso. putc e putchar sono simili a fputc e di _fputchar, rispettivamente, ma vengono implementati sia come funzioni che come macro (vedere Scelta tra le funzioni e le macro). putwc e putwchar sono versioni a caratteri estesi rispettivamente di putc e putchar.
Le versioni con il suffisso sono identiche ma non sono protette da interferenze da parte di altre thread. Potrebbero essere più veloci poiché non comportano un sovraccarico che blocca le altre thread. Utilizzare queste funzioni solo in contesti thread-safe come applicazioni a thread singolo o dove l'ambito chiamante già gestisce l'isolamento del thread.
Mapping di routine su testo generico
Routine TCHAR.H |
_UNICODE & _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
putchar |
<stdio.h> |
putwchar |
<stdio.h> o <wchar.h> |
La console non è supportata nelle applicazioni Windows Store. Gli handle del flusso standard associati alla console,stdin, stdout e stderr, devono essere reindirizzati prima di poter utilizzare le funzioni di runtime del linguaggio C nelle applicazioni Windows Store. Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.
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