putc, putwc
Scrivere un carattere a 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 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, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni EOF di ritorno 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.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 in interferenze da parte di altri thread.Per ulteriori informazioni, vedere _putc_nolock, _putwc_nolock.
Mapping di routine a Testo generico
TCHAR.H routine |
_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 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_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