putc, putwc

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Écrit un caractère dans un flux de données.

  
      int putc(  
   int c,  
   FILE *stream   
);  
wint_t putwc(  
   wchar_t c,  
   FILE *stream   
);  

Paramètres

c
Caractère à écrire.

stream
Pointeur vers fichier structure.

Retourne le caractère écrit. Pour indiquer une erreur ou une condition de fin de fichier, putc et putchar retourner EOF; putwc and putwchar return WEOF. Pour toutes les routines de quatre, utilisez ferror ou feof pour rechercher une erreur ou la fin du fichier. Si un pointeur null passé à stream, le Gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l’exécution est autorisée à se poursuivre, ces fonctions retournent EOF ou WEOF et errno à EINVAL.

Consultez la page _doserrno, errno, _sys_errlist et _sys_nerr pour plus d’informations sur les autres codes d’erreur.

Le putc routine écrit le caractère unique c à la sortie stream à la position actuelle. Tout entier peut être passé à putc, mais uniquement les 8 bits inférieurs sont écrits. Le putchar routine est identique à putc ( c , stdout). Pour chaque routine, si une erreur de lecture se produit, l’indicateur d’erreur pour le flux est définie. putcet putchar sont similaires aux fputc et _fputchar, respectivement, mais sont implémentées comme fonctions et macros (voir en choisissant entre les fonctions et Macros). putwc et putwchar sont, respectivement, des versions à caractères larges de putc et putchar. putwc et putc se comportent de la même façon si le flux est ouvert en mode ANSI. putcnon prise en charge sortie dans un flux de données UNICODE.

Les versions avec le _nolock suffixe sont identiques, sauf qu’ils ne sont pas protégés contre toute interférence par d’autres threads. Pour plus d’informations, consultez _putc_nolock, _putwc_nolock.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_puttcputcputcputwc
RoutineEn-tête requis
putc<stdio.h>
putwc<stdio.h> ou <wchar.h>

La console n'est pas prise en charge dans les applications Windows 8.x 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 du Windows 8.x Store. Pour plus d'informations sur la compatibilité, voir Compatibilité.

Toutes les versions des bibliothèques Runtime C.

// crt_putc.c  
/* This program uses putc to write buffer  
 * to a stream. If an error occurs, the program  
 * stops before writing the entire buffer.  
 */  
  
#include <stdio.h>  
  
int main( void )  
{  
   FILE *stream;  
   char *p, buffer[] = "This is the line of output\n";  
   int  ch;  
  
   ch = 0;  
   /* Make standard out the stream and write to it. */  
   stream = stdout;  
   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )  
      ch = putc( *p, stream );  
}  

This is the line of output  

Flux d’e/s
fputc, fputwc
getc, getwc

Afficher: