PUTS(3)

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 l'octet nul « \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 si elles réussissent et EOF si elles é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(2) sur le descripteur du fichier associé au flux. Le comportement est imprévisible et certainement pas celui que vous attendez.

VOIR AUSSI
write(2), ferror(3), fgets(3), fopen(3), fputwc(3), fputws(3), fseek(3), fwrite(3), putwchar(3), scanf(3), unlocked_stdio(3)

COLOPHON
Cette page fait partie de la publication 3.70 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Nicolas François et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <perkamon-fr@traduc.org>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».