https://github.com/live627/simple-config
Small INI parser true to the originals from the 1990's!
https://github.com/live627/simple-config
Last synced: 3 months ago
JSON representation
Small INI parser true to the originals from the 1990's!
- Host: GitHub
- URL: https://github.com/live627/simple-config
- Owner: live627
- License: mit
- Created: 2018-06-15T00:19:06.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-15T23:49:06.000Z (almost 7 years ago)
- Last Synced: 2025-01-22T11:29:00.696Z (5 months ago)
- Language: C
- Size: 8.79 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# simple-config
Small INI parser true to the originals from the 1990's!
* The main goal is to be small. I'm not worried about the number of instructions this may require, since it's really fire-and forget.
* An unordered map stores all the things. If this concerns you, use something else. Maps seem ideal for key/value pairs.
* Regular expressions are used to parse each line. They seem to have filtered the garbage that I've sent their way (as seem in `simple-config.cpp`)
* Comments get eaten (not preserevd). Run `simple-config.cpp` for proof. I have not tested inline comments.
* Quoted values have no special meaning. They are seen as a regular value, nothing special, and are not removed.
* Keys that are outside a section (the "default" section) are suppoeted.
* You may use a colon to separate key and value; the colon is equivalent to the equal sign. That is, the strings "Name: Value" and "Name=Value" have the same meaning.
* The hash character ("#") is an alternative for the semicolon to start a comment. Trailing comments (i.e. behind a key/value pair on a line) are allowed.
* Leading and trailing white space around key names and values is ignored.
* The memory footprint is deterministic. There is no dynamic memory allocation.
## How to use:
This is a **header-only** library. Just grab `simple-config.h` and include it. Does not interface with files at all, only streams.
- `stringstream`s will work. I use them in the demo (`simple-config.cpp`)
- Reading from a file is as simple as passing a `std::ifstream` to the constructor.
Developed in Visual Studio 2017 as a CMake project.