home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | CONFORMING TO | BUGS | SEE ALSO | COLOPHONThe Linux Programming Interface


PUTS(3)                       Linux Programmer's Manual                       PUTS(3)

NAME         top

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

SYNOPSIS         top

       #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         top

       fputc() writes the character c, cast to an unsigned char, to stream.

       fputs() writes the string s to stream, without its trailing '\0'.

       putc() is equivalent to fputc() except that it may be implemented as a macro
       which evaluates stream more than once.

       putchar(c); is equivalent to putc(c,stdout).

       puts() writes the string s and a trailing newline to 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 nonlocking counterparts, see unlocked_stdio(3).

RETURN VALUE         top

       fputc(), putc() and putchar() return the character written as an unsigned char
       cast to an int or EOF on error.

       puts() and fputs() return a nonnegative number on success, or EOF on error.

CONFORMING TO         top

       C89, C99.

BUGS         top

       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         top

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

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   1993-04-04                              PUTS(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable
counter