fputc, fputwc

Écrit un caractère dans un flux.

Syntaxe

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 retournée

Chacune de ces fonctions retourne le caractère écrit. Pour fputc, une valeur de retour égale à EOF indique une erreur. Pour fputwc, une valeur de retour égale à WEOF indique une erreur. Si stream c’est NULLle cas, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à continuer, elles retournent EOF et définissent errno sur EINVAL.

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

Chacune de ces fonctions écrit le caractère c unique dans un fichier à la position indiquée par l’indicateur de position de fichier associé, s’il est défini. Les fonctions avancent l’indicateur selon les besoins. Dans fputc et fputwc, le fichier est associé à stream. Si le fichier ne peut pas prendre en charge les demandes de positionnement ou a été ouvert en mode Ajout, le caractère est ajouté à la fin du flux.

Les deux fonctions se comportent de la même façon si le flux est ouvert en mode ANSI. fputc ne prend pas en charge la sortie vers un flux UNICODE pour l’instant.

Les versions avec le _nolock suffixe sont identiques, sauf qu’elles ne sont pas protégées contre les interférences par d’autres threads. Pour plus d’informations, consultez_fputc_nolock . _fputwc_nolock

Voici une série de notes spécifiques aux routines.

Routine	Notes
fputc	Équivalente à putc, mais implémentée uniquement comme une fonction, plutôt que comme une fonction et une macro.
fputwc	Version à caractères larges de fputc. Écrit c sous la forme d’un caractère multioctet ou d’un caractère large lorsqu’il stream est ouvert en mode texte ou en mode binaire, respectivement.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_fputtc	fputc	fputc	fputwc

Spécifications

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 plateforme Windows universelle (UWP). Les handles de flux standard associés à la consolestdin doivent stdoutstderrêtre redirigés avant que les fonctions d’exécution C puissent les utiliser dans les applications UWP. Pour plus d’informations sur la compatibilité, consultez Compatibility.

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

}

This is a test of fputc!!

Voir aussi

E/S de flux
fgetc, fgetwc
putc, putwc