---

fprintf()

Write output to a stream

Synopsis:

#include <stdio.h>

int fprintf( FILE* fp, 
             const char* format, 
             ... );

Arguments:

fp

The stream to which you want to send the output.

format

A string that specifies the format of the output. The formatting string determines what additional arguments you need to provide. For more information, see printf().

Library:

libc

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

Description:

The fprintf() function writes output to the stream specified by fp, under control of the format specifier.

Returns:

The number of characters written, or a negative value if an output error occurred (errno is set).

Examples:

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

char *weekday = { "Saturday" };
char *month = { "April" };

int main( void )
{
    fprintf( stdout, "%s, %s %d, %d\n",
        weekday, month, 10, 1999 );
        
    return EXIT_SUCCESS;
}

Produces:

Saturday, April 10, 1999

Classification:

ANSI, POSIX 1003.1

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

See also:

errno, fwprintf(), printf(), snprintf(), sprintf(), swprintf(), vfprintf(), vfwprintf(), vprintf(), vsnprintf(), vsprintf(), vswprintf(), vwprintf(), wprintf()

---