putchar, putwchar

 

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

Écrit un caractère à stdout.

  
      int putchar(  
   int c   
);  
wint_t putwchar(  
   wchar_t c   
);  

Paramètres

c
Caractère à écrire.

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, 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 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.

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. Ils peuvent être plus rapides, car elles n’entraînent pas la surcharge de verrouillage des autres threads. Utilisez ces fonctions uniquement dans les contextes thread-safe, tels que les applications à un seul thread ou lorsque la portée appelante gère déjà l'isolation des threads.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_puttcharputcharputcharputwchar
RoutineEn-tête requis
putchar<stdio.h>
putwchar<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_putchar.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;  
  
   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )  
      ch = putchar( *p );  
}  

This is the line of output  

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

Afficher: