Fclose

From aldeid
Jump to: navigation, search

Description

Closes the file associated with the stream and disassociates it.

All internal buffers associated with the stream are disassociated from it and flushed: the content of any unwritten output buffer is written and the content of any unread input buffer is discarded.

Even if the call fails, the stream passed as parameter will no longer be associated with the file nor its buffers.

Syntax

int fclose ( FILE * stream );

Parameters

stream
Pointer to a object that specifies the stream to be closed.

Return Value

If the stream is successfully closed, a zero value is returned.

On failure,
EOF
is returned.

Example

This simple code creates a new text file, then writes a sentence to it, and then closes it.

#include <stdio.h>
int main ()
{
  FILE * pFile;
  pFile = fopen ("myfile.txt","wt");
  fprintf (pFile, "fclose example");
  fclose (pFile);
  return 0;
}