putc
, putwc
Écrit un caractère dans un flux.
Syntaxe
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 FILE
.
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 vous avez passé un pointeur Null pour stream
, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à continuer, ces fonctions retournent EOF
ou WEOF
définissent la EINVAL
valeur errno
.
Pour plus d’informations sur les codes de retour, consultez , , _sys_errlist
_doserrno
et _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. putc
et 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
. 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 la sortie vers un flux UNICODE pour l’instant.
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. Pour plus d’informations, consultez _putc_nolock, _putwc_nolock.
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 |
---|---|---|---|
_puttc |
putc |
putc |
putwc |
Spécifications
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 plateforme Windows universelle (UWP). Les handles de flux standard associés à la console, stdin
et stdout
stderr
doivent ê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_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
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour