puts, fputc, fputs, putc, putchar − Ãcriture de caractères et de chaînes.

#include <stdio.h>

int fputc (int c, FILE *stream);
int fputs (const char *s, FILE *stream);
int putc (int c, FILE *stream);
int putchar (int c);
int puts (const char * s);

fputc() écrit le caractère c, transformé en unsigned char, dans le flux stream.

fputs() écrit la chaîne de caractères s dans le flux stream, sans écrire le « \0 » final.

putc() est équivalent à fputc() sauf qu’il peut être implémenté comme une macro évaluant plusieurs fois son argument stream.

putchar(c) est équivalent à putc(c,stdout).

puts() écrit la chaîne de caractères s et un retour-chariot final sur stdout.

Les appels de ces fonctions peuvent être utilisés conjointement, ainsi qu’avec les autres fonctions d’écriture de la bibliothèque stdio.

Pour des versions de ces fonctions ignorant les verrouillages, voir unlocked_stdio(3).

fputc(), putc() et putchar() renvoient le caractère écrit en tant qu’unsigned char, converti en int ou EOF en cas d’erreur.

puts() et fputs() renvoient un nombre non négatif s’ils réussissent et EOF s’ils échouent.

C89, C99.

Il est fortement déconseillé de mêler les fonctions d’écriture de stdio avec les appels bas-niveau write() sur le descripteur du fichier associé au flux. Les résultats sont imprévisibles.

write(2), ferror(3), fopen(3), fputwc(3), fputws(3), fseek(3), fwrite(3), gets(3), putwchar(3), scanf(3), unlocked_stdio(3)

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 5 novembre 1996 et révisée le 14 août 2006.

L’équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 puts ». N’hésitez pas à signaler à l’auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.