Partager via


putc, putwc

Écrit un caractère dans un flux.

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

Paramètres

  • c
    Caractère à écrire.

  • stream
    Pointeur vers la structure FICHIER.

Valeur de retour

Retourne le caractère écrit. Pour indiquer une erreur ou une condition fin de fichier, putc et putchar retournent EOF; putwc retourne WEOF, ainsi que putwchar. Pour les quatre routines, utilisez ferror ou feof pour vérifier une erreur ou une fin de fichier. Si un pointeur nul est passé pour stream, le gestionnaire de paramètres non valides 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 affectent à errno la valeur EINVAL.

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ces éléments et autres codes d'erreur.

Notes

La routine putc écrit le caractère unique c dans la sortie stream à la position actuelle. Tout entier peut être passé à putc, mais seuls les 8 bits de poids faible sont écrits. La routine putchar est identique à putc( c**,** stdout ). Pour chaque routine, si une erreur de lecture se produit, l'indicateur d'erreur pour le flux est défini. putc et putchar sont semblables à fputc et _fputchar, respectivement, mais sont implémentés en tant que fonctions et comme macros (consultez Choix entre des fonctions et des macros). putwc et putwchar, sont des versions à caractères larges de putc et putchar respectivement. putwc et putc se comportent de la même façon si le flux est ouvert en mode ANSI. putc ne prend pas en charge actuellement la sortie dans un flux UNICODE.

Les versions avec le suffixe _nolock sont identiques mais elles ne sont pas protégées contre les interférences en provenance d'autres threads. Pour plus d'informations, consultez _putc_nolock, _putwc_nolock.

Mappages de routines de texte générique

Routine TCHAR.H

_UNICODE & _MBCS non définis

_MBCS défini

_UNICODE défini

_puttc

putc

putc

putwc

Configuration requise

Routine

En-tête requis

putc

<stdio.h>

putwc

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

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

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

Sortie

This is the line of output

Équivalent .NET Framework

Voir aussi

Référence

E/S de flux

fputc, fputwc

getc, getwc