fputc, fputwc

Articolo
06/09/2015

Scrive un carattere in un flusso.

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

Parametri

c
Carattere da scrivere.
stream
Puntatore alla struttura FILE.

Valore restituito

Ognuna di queste funzioni restituisce il carattere scritto. Per fputc, un valore restituito di EOF indica un errore. Per fputwc, un valore restituito di WEOF indica un errore. Se il stream è NULL, queste funzioni richiamano il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono EOF e impostano errno su EINVAL.

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

Note

Ognuna di queste funzioni scrive il singolo carattere c in un file nella posizione indicata dall'indicatore collegato del percorso del file (se definito) e fanno avanzare l'indicatore in base alle proprie esigenze. Nel caso fputc e fputwc, il file viene associato con stream*.* Se il file non può supportare il posizionamento delle richieste o viene aperto in modalità di aggiunta, il carattere viene aggiunto alla fine del flusso.

Queste due funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI. fputc 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 altri thread. Per ulteriori informazioni, vedere_fputc_nolock, _fputwc_nolock.

I commenti di routine specifiche seguenti.

Routine	Note
fputc	Equivale a putc, ma viene implementato solo come funzione, anziché come una funzione e una macro.
fputwc	Versione a caratteri estesi di fputc. Scrive c come carattere multibyte o caratteri estesi a seconda di come stream viene aperto in modalità testo o in modalità binaria.

Mapping di routine su testo generico

Routine TCHAR.H	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_fputtc	fputc	fputc	fputwc

Requisiti

Funzione	Intestazione obbligatoria
fputc	<stdio.h>
fputwc	<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à.

Esempio

// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
 

#include <stdio.h>

int main( void )
{
   char strptr1[] = "This is a test of fputc!!\n";
   char *p;

   // Print line to stream using fputc. 
   p = strptr1;
   while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;

}