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