putc, putwc
Entrez 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 de 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 et retournent WEOFd' putwchar .Pour les quatre routines, utilise ferror ou feof vérifient une erreur ou de fin de fichier.Si passé un pointeur null pour stream, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, ces fonctions EOF de retour ou WEOF et affectez errno à EINVAL.
Consultez _doserrno, errno, _sys_errlist, et _sys_nerr pour plus d'informations sur ces éléments, et autres, les codes d'erreur.
Notes
La routine d' putc é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.La routine d' putchar identique à putc(c,stdout ).Pour chaque sous-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ées comme des fonctions et comme macros (voir l' Choix entre des fonctions et des macros).putwc et putwchar sont des versions à caractères larges d' putc et d' putchar, respectivement.putwc et putc se comportent de la même si le flux est ouvert en mode ANSI.putc ne prend pas en charge actuellement la sortie dans un flux d'UNICODE.
Les versions avec le suffixe " _nolock sont identiques sauf qu'elles ne sont pas protégés des interférence par d'autres threads.Pour plus d'informations, consultez _putc_nolock, _putwc_nolock.
Mappages de routines de texte générique
Routine de TCHAR.H |
_UNICODE et non définis _MBCS |
_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 d' Windows Store .Les handles standard de flux de données associés à la console, stdin, stdout, et stderr, doivent être redirigés pour que les fonctions runtime C peuvent les utiliser dans des applications d' Windows Store .Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.
Bibliothèques
Toutes les versions d' 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