Table of Contents

CSV Reader

#include<csv2/reader.hpp>intmain() {  csv2::Reader<csv2::delimiter<','>,                csv2::quote_character<'"'>,                csv2::first_row_is_header<true>,               csv2::trim_policy::trim_whitespace> csv;if (csv.mmap("foo.csv")) {constauto header = csv.header();for (constauto row: csv) {for (constauto cell: row) {// Do something with cell value// std::string value;// cell.read_value(value);      }    }  }}

Performance Benchmark

cd benchmarkg++ -I../include -O3 -std=c++11 -o main main.cpp./main<csv_file>

System Details

Results (as of 23 SEP 2022)

Reader API

template<classdelimiter = delimiter<','>,classquote_character = quote_character<'"'>,classfirst_row_is_header = first_row_is_header<true>,classtrim_policy = trim_policy::trim_whitespace>classReader {public:// Use this if you'd like to mmap and read from fileboolmmap(string_type filename);// Use this if you have the CSV contents in std::string alreadyboolparse(string_type contents);// Shapesize_trows()const;size_tcols()const;// Row iterator// If first_row_is_header, row iteration will start// from the second row  RowIteratorbegin()const;  RowIteratorend()const;// Access the first row of the CSV  Rowheader()const;};

// Row classclassRow {public:// Get raw contents of the rowvoidread_raw_value(Container& value)const;// Cell iterator  CellIteratorbegin()const;  CellIteratorend()const;};

// Cell classclassCell {public:// Get raw contents of the cellvoidread_raw_value(Container& value)const;// Get converted contents of the cell// Handles escaped content, e.g.,// """foo""" => ""foo""voidread_value(Container& value)const;};

CSV Writer

#include<csv2/writer.hpp>#include<vector>#include<string>usingnamespacecsv2;intmain() {    std::ofstreamstream("foo.csv");    Writer<delimiter<','>>writer(stream);    std::vector<std::vector<std::string>> rows =         {            {"a","b","c"},            {"1","2","3"},            {"4","5","6"}        };    writer.write_rows(rows);    stream.close();}

Writer API

template<classdelimiter = delimiter<','>>classWriter {public:// Construct using an std::ofstreamWriter(output_file_stream stream);// Use this to write a single row to filevoidwrite_row(container_of_strings row);// Use this to write a list of rows to filevoidwrite_rows(container_of_rows rows);

Compiling Tests

mkdir build&&cd buildcmake -DCSV2_BUILD_TESTS=ON ..makecdtest./csv2_test

Generating Single Header

python3 utils/amalgamate/amalgamate.py -c single_include.json -s.

Contributing

License