puts

Autres langues

Langue: fr

Version: 4 avril 1993 (fedora - 25/11/07)

Section: 3 (Bibliothèques de fonctions)

NOM

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

SYNOPSIS

 #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);
 

DESCRIPTION

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

VALEUR RENVOYÉE

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.

CONFORMITÉ

C89, C99.

BOGUES

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.

VOIR AUSSI

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

TRADUCTION

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.