PUTS(3)

NOMBRE
fputc, fputs, putc, putchar, puts - salida de caracteres y cadenas

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

DESCRIPCIÓN
fputc() escribe el carácter c, modelado a un unsigned char, en flujo.

fputs() escribe la cadena de caracteres s en flujo, sin su terminador '\0'.

putc() es equivalente a fputc() salvo en que puede estar implementada como una macro que evalúe flujo más de una vez.

putchar(c); equivale a putc(c,stdout);.

puts() escribe la cadena de caracteres s y un salto de línea final en stdout.

ungetc() devuelve el carácter c, modelado a un unsigned char, al flujo especificado, para que sea devuelto de nuevo en la próxima lectura. La biblioteca de GNU/Linux permite devolver EOF, aunque esto no es estándar ANSI C.

Las llamadas a las funciones descritas aquí pueden mezclarse unas con otras y con otras funciones de salida de la biblioteca stdio para el mismo flujo de salida, sin problemas.

Para las versiones no-bloqueantes, véase unlocked_stdio(3).

VALOR DEVUELTO
fputc(), putc() y putchar() devuelven el carácter escrito como un unsigned char modelado a un int o EOF en caso de error.

puts(), fputs() y ungetc() devuelven un número no negativo si acaban bien, o EOF en caso de error.

CONFORME A
C ANSI, POSIX.1

FALLOS
No es recomendable mezclar llamadas a funciones de salida de la biblioteca estándar stdio con llamadas de bajo nivel a write() para el descriptor de fichero asociado con el mismo flujo de salida; los resultados quedarán indefinidos y muy probablemente no serán los deseados.

VÉASE TAMBIÉN
write(2), ferror(3), fopen(3), fseek(3), fwrite(3), gets(3), scanf(3), unlocked_stdio(3)