fstream::fstream [constructor]
fstream ( );
explicit fstream ( const char * filename, openmode mode = in | out );

Construct an object and optionally open a file.
  Constructs an object of class fstream. This implies the initialization of the associated filebuf object and the call to its base class' constructor with the filebuf object as constructor parameter.
  Additionally, in case the second constructor syntax is used, the stream's file is associated with a physical file as if a call to member open with the same parameters was made.


String containing the name of the file to be opened.
Flags describing the requested i/o mode for the file. This is an object of type ios_base::openmode, it generally consist of a combination of the following flags (member constants):
app(append) Seek to the end of the stream before each output operation.
ate(at end) Seek to the end of the stream when opening.
binaryConsider stream as binary rather than text.
inAllow input operations on a stream.
outAllow output operations on a stream.
trunc(truncate) Truncate file to zero when opening.

Return Value.


// using fstream constructors.
#include <iostream>
#include <fstream>
using namespace std;

int main () {

  fstream filestr ("test.txt");

  // >> i/o operations here <<


  return 0;
This example simply opens and closes a file.

Basic template member declaration ( basic_fstream<charT,traits> ):
explicit basic_fstream  ( const char * filename, openmode mode = in | out );

See also.
  fstream class

© The C++ Resources Network, 2001