Condividi tramite

fputc, fputwc

  • Articolo

Scrive un carattere in un flusso.

Sintassi

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 EOF indica un errore. Per fputwc un valore restituito WEOF indica un errore. Se stream è NULL, queste funzioni richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, restituiscono EOF e impostano errno su EINVAL.

Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

Ognuna di queste funzioni scrive il singolo carattere c in un file nella posizione indicata dall'indicatore di posizione del file associato, se definito. Le funzioni avanzano l'indicatore in base alle esigenze. In fputc e fputwcil file è associato a stream. Se il file non può supportare le richieste di posizionamento o è stato aperto in modalità accodamento, 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 UNICODE.

Le versioni con il _nolock suffisso sono identiche, ad eccezione del fatto che non sono protette da interferenze da altri thread. Per altre informazioni, vedere_fputc_nolock . _fputwc_nolock

Seguono note specifiche per le routine.

Ciclo Osservazioni:
fputc Equivalente a putc, ma implementata solo come una funzione, anziché come una funzione e una macro.
fputwc Versione a caratteri wide di fputc. Scrive c come carattere multibyte o un carattere wide quando stream viene aperto rispettivamente in modalità testo o binaria.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine TCHAR.H _UNICODE e _MBCS non definito _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 app piattaforma UWP (Universal Windows Platform) (UWP). Gli handle di flusso standard associati alla console,stdinstdout e stderr, devono essere reindirizzati prima che le funzioni di runtime C possano usarle nelle app UWP. Per altre informazioni sulla compatibilità, vedere Compatibility (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 ) ;

}

This is a test of fputc!!

Vedi anche

I/O di flusso
fgetc, fgetwc
putc, putwc