fputc, fputwc
Écrit un caractère dans un flux.
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
Paramètres
c
Caractère à écrire.stream
Pointeur vers la structure FILE.
Valeur de retour
Chacune de ces fonctions retourne le caractère écrit. Pour fputc, une valeur de retour de EOF indique une erreur. Pour fputwc, une valeur de retour de WEOF indique une erreur. Si stream est NULL, ces fonctions appellent le gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, elles retournent EOF et définissent errno à la valeur EINVAL.
Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ces éléments et autres codes d'erreur.
Notes
Chacune de ces fonctions écrit le caractère unique c dans un fichier à la position indiquée par l'indicateur de position de fichier associé (si défini) et avance les indicateurs comme il le faut. Dans le cas de fputc et fputwc, le fichier est associé à stream*.* Si le fichier ne peut pas prendre en charge le positionnement de requêtes ou était ouvert en mode adjonction, le caractère est ajouté à la fin du flux.
Ces deux fonctions se comportent de la même façon si le flux est ouvert en mode ANSI. fputc ne prend pas en charge actuellement la sortie dans un flux UNICODE.
Les versions avec le suffixe _nolock sont identiques mais elles ne sont pas protégées contre les interférence en provenance d'autres threads. Pour plus d'informations, consultez_fputc_nolock, _fputwc_nolock.
Les remarques concernant les routines sont indiquées dans la suite.
Routine |
Remarques |
---|---|
fputc |
Équivalent à putc, mais implémenté uniquement comme une fonction plutôt que comme une fonction et une macro. |
fputwc |
Version à caractères larges de fputc. Ecrit c comme un caractère multioctets ou caractère large selon que stream est ouvert en mode texte ou en mode binaire. |
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE & _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
Configuration requise
Fonction |
En-tête requis |
---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> ou <wchar.h> |
La console n'est pas prise en charge dans les applications Windows Store . Les handles de flux standard associés à la console, stdin, stdout et stderr doivent être redirigés pour que les fonctions runtime C puissent les utiliser dans les applications Windows Store . Pour plus d'informations sur la compatibilité, consultez Compatibilité.
Exemple
// 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 ) ;
}