fputs

 

C

Language

Standard Library

Type support

Dynamic memory management

Error handling

Program utilities

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Thread support (C11)

Atomic operations (C11)

 

File input/output

Functions
File access
fopen freopen fclose fflush	fwide setbuf setvbuf
Direct input/output
fread
fwrite
Unformatted input/output
fgetc fgets fputc fputs getchar gets putchar puts ungetc	fgetwc fgetws fputwc fputws getwchar putwchar ungetwc
Formatted input/output
scanffscanfsscanf vscanfvfscanfvsscanf (C99)(C99)(C99) printffprintfsprintfsnprintf (C99) vprintfvfprintfvsprintfvsnprintf (C99)	wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C99)(C99)(C99) wprintffwprintfswprintf vwprintfvfwprintfvswprintf
File positioning
ftell
fgetpos
fseek
fsetpos
rewind
Error handling
clearerr
feof
ferror
perror
Operations on files
remove
rename
tmpfile
tmpnam

 

Defined in header <stdio.h>
int fputs( const char          *str, FILE          *stream );		(until C99)
int fputs( const char *restrict str, FILE *restrict stream );		(since C99)

Writes given null-terminated character string to the given output stream.

Parameters

str	-	null-terminated character string to be written
stream	-	output stream

Return value

Non-negative integer on success, EOF on failure.

Example

fputs() with error checking

Run this code

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    int ret_code = fputs("Hello World",stdout);
    if ((ret_code == EOF) && (ferror(stdout)))   /* test whether EOF was reached */
    {
       perror("fputs()");
       fprintf(stderr,"fputs() failed in file %s at line # %d\n", __FILE__,__LINE__-4);
       exit(EXIT_FAILURE);
    }
 
    return EXIT_SUCCESS;
}

Output:

Hello World

See also

printffprintfsprintfsnprintf (C99)	prints formatted output to stdout, a file stream or a buffer (function)
puts	writes a character string to stdout (function)
fgets	gets a character string from a file stream (function)
C++ documentation for fputs