putchar, putwchar

Écrit un caractère dans stdout.

Syntaxe

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

Paramètres

c
Caractère à écrire.

Valeur retournée

Retourne le caractère écrit. Pour indiquer une erreur ou une condition de fin de fichier, putc et putchar retourner EOF; putwc et putwchar retourner WEOF. Pour les quatre routines, utilisez ferror ou feof case activée pour une erreur ou une fin de fichier. Si le pointeur Null est passé, streamces 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, elles retournent EOF ou WEOFsont définies sur errnoEINVAL.

Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

La routine putc écrit le caractère unique c dans la sortie stream à la position actuelle. Il est possible de passer un entier à putc, mais seuls les 8 bits inférieurs sont écrits. La putchar routine est identique à putc( c, stdout ). Pour chaque routine, si une erreur de lecture se produit, l’indicateur d’erreur du flux est défini. putcet putchar sont similaires à fputc et _fputchar, respectivement, mais sont implémentés à la fois en tant que fonctions et en tant que macros (voir Recommandations pour choisir entre les fonctions et les 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’elles ne sont pas protégées contre les interférences par d’autres threads. Ils peuvent être plus rapides, car ils n’entraînent pas de surcharge de verrouillage d’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.

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 routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_puttchar	putchar	putchar	putwchar

Spécifications

Routine	En-tête requis
putchar	<stdio.h>
putwchar	<stdio.h> ou <wchar.h>

La console n’est pas prise en charge dans les applications plateforme Windows universelle (UWP). Les handles de flux standard associés à la console, stdinet stdoutstderrdoivent être redirigés avant que les fonctions d’exécution C puissent les utiliser dans les applications UWP. Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

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

Sortie

This is the line of output

Voir aussi

E/S de flux
fputc, fputwc
getc, getwc