_fputchar, _fputwchar

Article
06/09/2015

Écrit des caractères dans stdout.

int _fputchar(
   int c 
);
wint_t _fputwchar(
   wchar_t c 
);

Paramètres

c
Caractère à écrire.

Valeur de retour

Chacune de ces fonctions retourne le caractère écrit. Pour _fputchar, une valeur de retour de EOF indique une erreur. Pour _fputwchar, une valeur de retour de WEOF indique une erreur. Si c est NULL, ces fonctions génèrent une exception de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, elles renvoient EOF(ouWEOF) et définissent errno à EINVAL.

Pour plus d'informations sur ces codes d'erreur et d'autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.

Notes

Ces deux fonctions écrivent le caractère unique c à stdout et avance l'indicateur approprié. _fputchar équivaut à fputc(stdout ). Elle est aussi équivalente à putchar, mais implémenté uniquement comme une fonction plutôt que comme une fonction et une macro. Contrairement à fputc et putchar, ces fonctions ne sont pas compatibles avec la norme ANSI.

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

Configuration requise

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