fputc.3.gz

PUTS

NAME

fputc, fputs, putc, putchar, puts - output of characters and strings

SYNOPSIS

#include <stdio.h>
 I int fputc(int  c , FILE * stream );

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

DESCRIPTION

R fputc () writes the character R c , cast to an R unsigned char , to R stream .
R fputs () writes the string s to R stream , without its trailing R '\0' .
R putc () is equivalent to R fputc () except that it may be implemented as a macro which evaluates stream more than once.
I putchar( c ); is equivalent to I putc( c , stdout ).
R puts () writes the string s and a trailing newline to R stdout .
Calls to the functions described here can be mixed with each other and with calls to other output functions from the stdio library for the same output stream.
For non-locking counterparts, see unlocked_stdio(3).

RETURN VALUE

R fputc (), R putc () and R putchar () return the character written as an unsigned char cast to an int or EOF on error.
R puts () and R fputs () return a non-negative number on success, or EOF on error.

CONFORMING TO

C89, C99

BUGS

It is not advisable to mix calls to output functions from the stdio library with low-level calls to write(2) for the file descriptor associated with the same output stream; the results will be undefined and very probably not what you want.

SEE ALSO

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