putc, putwc
Scrive un carattere in un flusso.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parametri
c
Carattere da scrivere.stream
Puntatore alla struttura FILE.
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 la fine del file. Se viene passato un puntatore a null per stream, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono EOF oppure WEOF e impostano errno a 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 "wide" rispettivamente di putc e putchar. putwc e putc si comportano in modo identico se il flusso viene aperto in modalità ANSI. putc non supporta attualmente l'output in un flusso UNICODE.
Le versioni con il suffisso _nolock sono identiche ma non sono protette da interferenze da parte di altre thread. Per ulteriori informazioni, vedere _putc_nolock, _putwc_nolock.
Mapping di routine su testo generico
Routine TCHAR.H |
_UNICODE & _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
putc |
<stdio.h> |
putwc |
<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_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 );
}
Output
This is the line of output