Coding Techniques
File Handling (fstream) · Study material
Make streams throw on errors
By default streams only set flags. Calling exceptions(failbit | badbit) makes them throw std::ios_base::failure, which is handy when a missing or unreadable file should abort an operation.
#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>
// Ask the stream to THROW instead of silently setting flags
std::string read_config(const std::filesystem::path& p) {
std::ifstream in;
in.exceptions(std::ifstream::failbit | std::ifstream::badbit);
in.open(p); // throws std::ios_base::failure if it cannot open
std::string first;
std::getline(in, first);
return first;
}
int main() {
const auto tmp = std::filesystem::temp_directory_path();
std::ofstream(tmp / "lf_config.ini") << "theme=dark\n";
for (const char* name : {"lf_config.ini", "lf_missing.ini"}) {
try {
std::string value = read_config(tmp / name); // may throw: call it before printing
std::cout << name << ": " << value << '\n';
} catch (const std::ios_base::failure&) {
std::cout << name << ": could not be read\n";
}
}
std::filesystem::remove(tmp / "lf_config.ini");
return 0;
}
lf_config.ini: theme=dark lf_missing.ini: could not be read
The correct reading loops
std::ifstream in("data.txt");
if (!in) { /* report: could not open */ }
for (std::string line; std::getline(in, line); ) { … } // ✔ line by line
for (int x; in >> x; ) { … } // ✔ number by number
for (char c; in.get(c); ) { … } // ✔ every character
while (!in.eof()) { // ✘ checks BEFORE reading:
std::getline(in, line); // the last line is processed twice,
process(line); // and bad data loops forever
}
int age; std::string name;
in >> age;
std::getline(in >> std::ws, name); // ✔ skip the newline left by >> Safe file updates: write a temp file, then rename
namespace fs = std::filesystem;
void save(const fs::path& target, const std::string& data) {
fs::path tmp = target;
tmp += ".tmp";
{
std::ofstream out(tmp, std::ios::binary);
out << data;
if (!out) throw std::runtime_error("write failed");
} // flushed and closed
fs::rename(tmp, target); // replaces the old file in one step:
} // readers never see a half-written file File handling checklist
- Check that every file opened; report the path in error messages.
- Let destructors close files; keep stream objects in the smallest scope.
- Loop on read operations, not on eof().
- Choose the mode deliberately: trunc (default), app or in|out.
- Use binary mode and fixed-size records for raw data; text for human-readable data.
- Use std::filesystem for paths and directory work.
- Write to a temporary file and rename it for crash-safe saves.