Skip to content

fleschutz/csv2hpp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

243 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CSV2HPP

This command-line utility converts the content of a CSV file (comma-separated values) into a header file for C/C++ software projects. Just #include the resulting header file and immediately start to develop on a structured, well-formed dataset (avoiding error-prone steps like file delivering, loading, parsing, converting, and checking).

▶️ Usage

  1. Export or download your database in CSV format, e.g. to: bucket_list.csv
  2. Open the CSV file in a text editor and add datatype hints to the header line, e.g.: Location (std::string), Latitude (double), Longitude (double)
  3. Execute in a terminal window: csv2hpp bucket_list.csv POI > bucket_list.hpp.
  4. Copy the generated header file into your project and include it (#include "bucket_list.hpp").

💡 Hints

  • Build csv2hpp by executing: cd src && cmake . && make (just requires cmake and a C++ compiler)
  • Datatype hints are mapped to C/C++ datatypes as follows: (std::string)std::string, (double)double, (skip) skips the entire column. Supported are 95 datatype hints as defined in: datatype_hints.csv
  • Empty CSV data cells are mapped to "" for strings and to 00 for everything else (as a hint).
  • Precision hints such as '±05' are removed in float or double values (not supported in C/C++).
  • Supports also big .CSV files: omits whitespaces, removes trailing '0'. It's recommended to use 'const char*' instead of 'std::string' which can break some compilers.
  • More conversion examples can be found in the 📁examples subfolder.

🤝 Contributing

  • Contributions, suggestions, and improvements are welcome!
  • Open an Issue if you encounter bugs or have feature ideas.
  • Create a Pull Request if you'd like to improve something.

📜 License & Copyright

This open source project is licensed under the CC0-1.0 license. All trademarks are the property of their respective owners.