fputs() — Write String
Format
#include <stdio.h>
int fputs(const char *string, FILE *stream);
Language Level
ANSI
Threadsafe
Yes
Description
The fputs()
function
copies string to the output stream at
the current position. It does not copy the null character (\0)
at the end of the string.
Return Value
The fputs()
function
returns EOF if an error occurs; otherwise, it returns a non-negative
value.
The fputs()
function
is not supported for files that are opened with type=record.
For information about errno values for fputs()
, see fputc() — Write Character.
Example
This example writes a string to
a stream.
#include <stdio.h>
#define NUM_ALPHA 26
int main(void)
{
FILE * stream;
int num;
/* Do not forget that the '\0' char occupies one character */
static char buffer[NUM_ALPHA + 1] = "abcdefghijklmnopqrstuvwxyz";
if ((stream = fopen("mylib/myfile", "w")) != NULL )
{
/* Put buffer into file */
if ( (num = fputs( buffer, stream )) != EOF )
{
/* Note that fputs() does not copy the \0 character */
printf( "Total number of characters written to file = %i\n", num );
fclose( stream );
}
else /* fputs failed */
perror( "fputs failed" );
}
else
perror( "Error opening myfile" );
}