Ultra Light INI Parser Files

What is Ultra Light INI Parser?
**********************************

Ultra Light INI Parser is a free (as in "free speech" and also as in "free beer") source code parser. It is written in c++ and is siutable for any sytem (Windows, Windows CE, Linux, UNIX, etc).
Its use is governed by GPL License.



Why another INI Parser?
***************************

While working on a Windows CE application i have ran into the problem that the well known WritePrivateProfileString and GetPrivateProfileString are not implemented in Windows CE.
Looked around in internet for an open source parser. I Found few but i was astonished on how complicated they were for the simple tast they were supposed to do (just read simple file and parse it and eventually write in it).
Most of all - what i found wasn't easy to simply include into my project and compile under windows CE.
The next step was to make my own parser and publish it as open source for the sake of humanity and my own satisfaction :)


Futures:
*********
Does exactly the same as the windows functions WritePrivateProfileString and GetPrivateProfileString plus few more extras.
- Enumerate all the sections in the INI file
- Enumerate all the keys in a given section in the INI file
- Reads particular value from a key and section (optionaly you can even read the leading and trailing whitespaces of the value you are reading)
                example: key1= value1   ;you can read only the string "value1" or optionally the whole string after the '=' character: " value1   "
- Write value in a key and section WITHOUT deleting the existing comment on that key
                example: key2= value2   ;this is the comment of key2. This parser will not remove this comment if you overwrite value2 with value3
				you can even write a comment along with the new value.

With very easy and small modifications the parser can be used to parse .config files

Usage:
********
Just put the files ini_parser.cpp and ini_parser.h somewhere in a folder on your computer and include them into your c++ project . Then you can compile and use the declared function

Note: In some point in the source code is used the function _chsize. Under some systems this function is not defined. Instead you can use the function ftruncate. 
           I didn't have the opportunity to test that so you might need a little modification of the source code to compile it. But thats a minor problem that can be fixed under 5 minutes.
	
	
	
Web sites:
***********

	https://sourceforge.net/projects/ultralightini/