fputc, fputwc
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!!