fputc, fputwc

Articolo
03/26/2013

Scrive un carattere a 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 stream è NULL, queste funzioni richiamare il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, restituiscono EOF e errno stabilito a 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 a un file nella posizione indicata dall'indicatore collegato del percorso del file (se definito) e avanzamenti l'indicatore in base alle proprie esigenze.Nel caso di fputc e di fputwc, il file viene associato a stream*.* Se il file non può supportare il posizionamento delle richieste o si apra in aggiunge la modalità, il carattere viene aggiunto alla fine del flusso.

Le due funzioni si comportano in modo identico se il flusso viene aperto in modalità ANSI.fputc non supporta attualmente l'output in un flusso di 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 Routine- specifiche di seguito.

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

Mapping di routine a Testo generico

TCHAR.H routine	_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 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.

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 ) ;

}