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 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 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. Les résultats sont imprévisibles et ne sont très probablement pas ceux que vous attendiez.

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 17 juillet 2008.

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.