The Simplest Way to Read CSV Files in C++ (No Libraries Needed)

If you have ever worked with data in C++, you have likely hit a common roadblock: How do I read a CSV file?

In languages like Python, this is a one-line command. In C++, however, there is no built-in read_csv function in the standard library. Most tutorials will tell you to install huge external libraries like Boost or specialized CSV parsers. But what if you just want a quick, simple solution without the hassle of managing dependencies?

Pro Tip: Before you can read a file, you often need to find it first. If you need to iterate through directories or handle cross-platform file paths safely, check out my Ultimate Guide to C++17 std::filesystem.

In this guide, I will show you how to read and write CSV files using only standard C++ (STL). This solution is lightweight, portable, and perfect for simple data tasks.

---

The Strategy: String Streams

The secret to parsing CSVs efficiently in C++ lies in the <sstream> header. By treating each line of the file as a stream of text, we can "tokenize" it using the comma delimiter.

Here is the plan:

1. Open the file using std::ifstream.
2. Read the file line-by-line using std::getline.
3. Convert each line into a std::stringstream.
4. Split the line by commas and store the values.

---

The Code: A Simple CSV Reader Class

You can copy this class directly into your project. It reads a CSV file and returns the data as a "vector of vectors" (a grid of strings).

#include <iostream>
#include <fstream>
#include <vector>
#include <sstream>
#include <string>

// Function to read a CSV file into a vector of string vectors
std::vector<std::vector<std::string>> readCSV(const std::string& filename) {
    std::vector<std::vector<std::string>> content;
    std::vector<std::string> row;
    std::string line, word;

    std::ifstream file(filename);

    if (file.is_open()) {
        while (getline(file, line)) {
            row.clear();
            std::stringstream str(line);

            while (getline(str, word, ',')) {
                row.push_back(word);
            }
            content.push_back(row);
        }
    } else {
        std::cerr << "Could not open the file!\n";
    }

    return content;
}

int main() {
    // Example Usage
    std::string filename = "data.csv";
    
    // Make sure you create a dummy 'data.csv' file first!
    auto data = readCSV(filename);

    std::cout << "Read " << data.size() << " rows from file.\n\n";

    // Print the data
    for (const auto& row : data) {
        for (const auto& col : row) {
            std::cout << col << " | ";
        }
        std::cout << "\n";
    }

    return 0;
}

---

Handling Edge Cases

The simple code above works for 90% of use cases. However, real-world data can be messy. Here are two quick improvements you might need:

1. Removing Spaces

Sometimes CSVs have spaces after commas (e.g., "apple, banana, orange"). The standard parser includes these spaces. You may want to trim them.

2. Header Rows

Often, the first row of a CSV contains labels (like "Name", "Age", "ID"). If you want to skip this row, simply call getline once before entering the while loop:

if (file.is_open()) {
    // Skip the first line (header)
    std::string header;
    getline(file, header); 

    while (getline(file, line)) {
        // ... rest of the loop
    }
}

---

Why Avoid Libraries?

While libraries like RapidCSV are powerful, they introduce "dependency hell." If you are writing a small tool or a school assignment, setting up CMake or adding header files is overkill.

Using the standard library approach ensures your code runs on any machine with a C++ compiler, from a Raspberry Pi to a high-end server, with zero installation required.

---

Summary

Reading CSV files in C++ doesn't have to be hard. By combining ifstream with stringstream, you can parse data effectively in under 30 lines of code.

Next time you need to load a dataset, try this method before reaching for a heavy external library. Your compiler will thank you!

Looking for more C++ file handling tips? Don't forget to read the Ultimate Guide to C++17 std::filesystem to master directory iteration.

The Simplest Way to Read CSV Files in C++ (No Libraries Needed)