_fputchar
, _fputwchar
Écrit un caractère dans stdout
.
Syntaxe
int _fputchar(
int c
);
wint_t _fputwchar(
wchar_t c
);
Paramètres
c
Caractère à écrire.
Valeur retournée
Chacune de ces fonctions retourne le caractère écrit. Pour _fputchar
, une valeur de retour égale à EOF
indique une erreur. Pour _fputwchar
, une valeur de retour égale à WEOF
indique une erreur. Si c est NULL
, ces fonctions génèrent une exception de paramètre non valide, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à continuer, _fputchar
retourne (_fputwchar
retourne WEOF
EOF
) et est définie errno
sur EINVAL
.
Pour plus d’informations sur ces codes d’erreur et d’autres codes d’erreur, consultez errno
, _doserrno
, _sys_errlist
et _sys_nerr
.
Notes
Ces deux fonctions écrivent l’argument c
caractère unique et stdout
avancent l’indicateur selon les besoins. _fputchar
est équivalent à fputc( stdout )
. Elle équivaut également à putchar
, mais implémentée uniquement en tant que fonction, plutôt qu’en tant que fonction et macro. Contrairement fputc
à et putchar
, ces fonctions ne sont pas compatibles avec la norme ANSI.
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 routines de texte générique
Routine Tchar.h | _UNICODE et _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_fputtchar |
_fputchar |
_fputchar |
_fputwchar |
Spécifications
Fonction | En-tête requis |
---|---|
_fputchar |
<stdio.h> |
_fputwchar |
<stdio.h> ou <wchar.h> |
La console n’est pas prise en charge dans les applications de la plateforme Windows universelle (UWP). Les handles de flux standard associés à la console (stdin
, stdout
et stderr
) doivent être redirigés pour que les fonctions de runtime C puissent les utiliser dans des applications UWP. Pour plus d’informations sur la compatibilité, consultez Compatibility.
Exemple
// crt_fputchar.c
// This program uses _fputchar
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr[] = "This is a test of _fputchar!!\n";
char *p = NULL;
// Print line to stream using _fputchar.
p = strptr;
while( (*p != '\0') && _fputchar( *(p++) ) != EOF )
;
}
This is a test of _fputchar!!