Partager via


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 d' FILE .

Valeur de retour

Chacune de ces fonctions retourne le caractère écrit.Pour fputc, une valeur de retour d' EOF indique une erreur.Pour fputwc, une valeur de retour d' WEOF indique une erreur.Si stream est NULL, ces fonctions appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, ils retournent EOF et le positionnement errno à EINVAL.

Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ces éléments, et autres, les codes d'erreur.

Notes

Chacune de ces fonctions des écrit le caractère unique c à un fichier à la position indiquée par l'indicateur de position de fichier associé (s'il est défini) et les délais d'avance l'indication de type approprié.Dans le cas de fputc et d' fputwc, le fichier est associé à stream*.* Si le fichier ne peut pas prendre en charge le positionnement des requêtes ou a été ouvert en mode adjonction, le caractère est ajouté à la fin de le flux.

Les deux fonctions se comportent de la même si le flux est ouvert en mode ANSI.fputc ne prend pas en charge actuellement la sortie dans un flux d'UNICODE.

Les versions avec le suffixe d' _nolock sont identiques sauf qu'elles ne sont pas protégés des interférence par d'autres threads.Pour plus d'informations,consultez_fputc_nolock, _fputwc_nolock.

Les notes Sous-programme- en détail ci-dessous.

Routine

Remarques

fputc

Équivalent à putc, mais implémentée uniquement comme fonction, plutôt que comme fonction et macro.

fputwc

Version à caractère élargi d' fputc.Écrit c en tant que caractères multioctet ou caractère élargi selon qu' stream est ouvert en mode texte ou le mode binaire.

Mappages de routines de texte générique

Routine de TCHAR.H

_UNICODE et non définis _MBCS

_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 d' Windows Store .Les handles standard de flux de données associés à la console, stdin, stdout, et stderr, doivent être redirigés pour que les fonctions runtime C peuvent les utiliser dans des applications d' Windows Store .Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.

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

}
  

Équivalent .NET Framework

Voir aussi

Référence

E/S de flux

fgetc, fgetwc

putc, putwc