261

Do I need to manually call close() when I use a std::ifstream?

For example, in the code:

std::string readContentsOfFile(std::string fileName) {

  std::ifstream file(fileName.c_str());

  if (file.good()) {
      std::stringstream buffer;
      buffer << file.rdbuf();
      file.close();

      return buffer.str();
  }
  throw std::runtime_exception("file not found");
}

Do I need to call file.close() manually? Shouldn't ifstream make use of RAII for closing files?

4 Answers 4

315

NO

This is what RAII is for, let the destructor do its job. There is no harm in closing it manually, but it's not the C++ way, it's programming in C with classes.

If you want to close the file before the end of a function you can always use a nested scope.

In the standard (27.8.1.5 Class template basic_ifstream), ifstream is to be implemented with a basic_filebuf member holding the actual file handle. It is held as a member so that when an ifstream object destructs, it also calls the destructor on basic_filebuf. And from the standard (27.8.1.2), that destructor closes the file:

virtual ˜basic_filebuf();

Effects: Destroys an object of class basic_filebuf<charT,traits>. Calls close().

14
  • 8
    +1 I didn't know that RAII handles that...I guess you learn something new everyday
    – TStamper
    Commented Apr 14, 2009 at 15:21
  • 40
    Using a nested scope just to close the file is completely artificial - if you mean to close it, call close() on it.
    – anon
    Commented Apr 14, 2009 at 15:23
  • 5
    Although, you might be able to argue that restricting the object's lifetime to the necessary scope means that you won't accidentally access a closed ifstream. But that's a bit contrived.
    – Eclipse
    Commented Apr 14, 2009 at 15:26
  • 16
    In C++ nested scopes are almost never unnecessary. They have everything to do with the behavior of the code, especially when something throws. If a future maintainer removes them, he doesn't know C++ very well. Commented Nov 14, 2013 at 22:39
  • 5
    @ssfang (hope you don't mind such a late comment): 1.: This constructor is not standard, so must be a MSVC extension. 2.: This behaviour can be considered natural: Stream closes what it opened itself and does not close what it did not open itself...
    – Aconcagua
    Commented Jul 19, 2017 at 9:41
84

Do you need to close the file?
NO

Should you close the file?
Depends.

Do you care about the possible error conditions that could occur if the file fails to close correctly? Remember that close calls setstate(failbit) if it fails. The destructor will call close() for you automatically because of RAII but will not leave you a way of testing the fail bit as the object no longer exists.

4
  • I think it's worth mentioning that you can use the exceptions function to turn such an error into an exception throw instead of doing a manual test. There's an interesting blog post by Eric Lippert which makes a good case for file IO being an example of a situation where exceptions are truly the better option because of their inherant asynchrony. I.e. a mounted disk count be removed at any time, not just when your program checks it's there.
    – Pharap
    Commented Sep 27, 2022 at 10:38
  • Since destructors aren't allowed to throw exceptions, we'll still lose that information if we don't close(). Commented Jan 22 at 16:43
  • @TobySpeight So it depends on what you are going to do with the error. If you can do something (alert the user / error log) then manually calling close() gives you that option. If there is nothing you can do that has a meaningful impact then let RAII handle it. Commented Jan 22 at 19:50
  • My comment was in reply to @Pharap; sorry if that wasn't obvious. Commented Jan 22 at 20:22
9

You can allow the destructor to do its job. But just like any RAII object there may be times that calling close manually can make a difference. For example:

#include <fstream>

using std::ofstream;

int main() {
  ofstream ofs("hello.txt");
  ofs << "Hello world\n";
  return 0;
}

writes file contents. But:

#include <stdlib.h>

#include <fstream>

using std::ofstream;

int main() {
  ofstream ofs("hello.txt");
  ofs << "Hello world\n";
  exit(0);
}

doesn't. These are rare cases where a process suddenly exits. A crashing process could do similar.

7

No, this is done automatically by the ifstream destructor. The only reason you should call it manually, is because the fstream instance has a big scope, for example if it is a member variable of a long living class instance.

1
  • 7
    Another reason might be to check file-closing errors and to prevent throwing destructor, if exceptions are allowed with the stream. Commented Jul 19, 2017 at 9:13

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.