Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

fputs()

Write a string to an output stream

Synopsis:

#include <stdio.h>

int fputs( const char* buf, 
           FILE* fp );

Arguments:

buf
The string you want to write.
fp
The stream you want to write the string to.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fputs() function writes the character string specified by buf to the output stream specified by fp.


Note: The terminating NUL character isn't written.

Returns:

A nonnegative value for success, or EOF if an error occurs (errno is set).

Examples:

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
    FILE *fp_in, *fp_out;
    char buffer[80];

    fp_in = fopen( "file", "r" );
    fp_out = fopen( "outfile", "w" );
    if( fp_in != NULL && fp_out != NULL) {
        while( fgets( buffer, 80, fp_in ) != NULL ) {
            fputs( buffer, fp_out );
        }
        fclose( fp_in );
        fclose( fp_out );
        
        return EXIT_SUCCESS;
    }
    
    return EXIT_FAILURE;
}

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point Yes
Interrupt handler No
Signal handler No
Thread Yes

See also:

errno, fgets(), fopen(), fprintf(), fputc(), putc(), puts()