Click here to Skip to main content
15,861,172 members
Articles / Programming Languages / C++
Article

CIniFile

Rate me:
Please Sign up or sign in to vote.
4.39/5 (16 votes)
31 May 2005 448.1K   2.8K   86   151
A class that makes it easy to implement an INI settings file in your applications.

Sample Image - cinifile.gif

Introduction

In every program I have written, I end up using some sort of INI file to keep settings from one run to the next. Instead of implementing it separately in each program, I finally got around to writing this class, CIniFile. It is simple to set up and use.

After you create your CIniFile object, call the member function SetPath(CString newpath) to set the path/filename for the INI file to read from and write to.

To read the INI file data into the class, call ReadFile().

To retrieve data from the class, use GetValue or one of its overloads:

//returns value of keyname/valuename as CString
CString GetValue(CString keyname, CString valuename);

//returns value of keyname/valuename as int
int GetValueI(CString keyname, CString valuename);
 
//returns value of keyname/valuename as double
double GetValueF(CString keyname, CString valuename);

To set data values in the class, call SetValue or one of its overloads:

bool SetValue(CString key, CString valuename, CString value, bool create = 1); 
bool SetValueI(CString key, CString valuename, int value, bool create = 1);
bool SetValueF(CString key, CString valuename, double value, bool create = 1);

Use the optional parameter create as false if you do not want it to create the key/value if it doesn't already exist.

SetValue returns TRUE if the value was successfully stored, FALSE otherwise.

To delete a value from the class, call DeleteValue(CString keyname, CString valuename). This function will return TRUE if the value is deleted, FALSE otherwise.

To delete an entire key from the class, call DeleteKey(CString keyname). This function will return TRUE if the key is deleted, FALSE otherwise.

To remove all data stored in the class, call Reset().

Other useful functions are GetNumKeys() which returns the number of keys in the INI file and GetNumValues(CString keyname) which returns the number of values stored in the specified key.

Finally, to write all your stored data to the specified INI file, call WriteFile().

That's it! It is simple.

Email comments to cabadam@tamu.edu.

Updates

  • 5 May 2000

    Updated source and demo files.

  • 2 March 2003

    It has been a long time since I've looked at this article, but as there has been a lot of interest in the non-MFC version of this class, I decided to go ahead and upload it here. As the non-MFC version, rewritten by Shane Hill, contains many more features, I've decided to remove the original MFC class from here. This means a couple things. First - the demo picture at the top of this article is wrong. There are no spaces surrounding the '=' sign. Also, even though the class contains many more features, the basic operation of the class remains the same for the most part. New features include the ability to enumerate existing keys and values and to add comments into the INI file. For the new additions, see the well documented header file.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Web Developer
United States United States
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralRe: inifile.h is not including in view class of MFC Pin
Adam Clauss2-May-05 11:06
Adam Clauss2-May-05 11:06 
GeneralRe: inifile.h is not including in view class of MFC Pin
nazia1234-May-05 0:11
nazia1234-May-05 0:11 
GeneralWin98 Problems Pin
Anonymous27-Apr-05 9:11
Anonymous27-Apr-05 9:11 
GeneralRe: Win98 Problems Pin
Adam Clauss27-Apr-05 11:22
Adam Clauss27-Apr-05 11:22 
GeneralLittle improvement Pin
Dennis Kuppens12-Apr-05 9:46
Dennis Kuppens12-Apr-05 9:46 
QuestionWhat about unicode support? Pin
bebert13-May-04 23:32
bebert13-May-04 23:32 
AnswerRe: What about unicode support? Pin
Adam Clauss25-Jun-04 9:31
Adam Clauss25-Jun-04 9:31 
GeneralWarnings.... Pin
momo77-May-04 0:35
momo77-May-04 0:35 
Hye!!

I use your files but i still have 5 warnings:

c:\program files\microsoft visual studio\vc98\include\vector(39) : warning C4786: 'std::reverse_iterator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > const *,std::basic_string<char,std::char_traits<char>,std::allocator<char>
>,std::basic_string<char,std::char_traits<char>,std::allocator<char> > const &,std::basic_string<char,std::char_traits<char>,std::allocator<char> > const *,int>' : identifier was truncated to '255' characters in the debug information
c:\program files\microsoft visual studio\vc98\include\vector(39) : while compiling class-template member function '__thiscall std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<c
har,std::char_traits<char>,std::allocator<char> > > >::std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > > >(const std::allocator<std:
:basic_string<char,std::char_traits<char>,std::allocator<char> > > &)'
c:\program files\microsoft visual studio\vc98\include\vector(39) : warning C4786: 'std::reverse_iterator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > *,std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std:
:basic_string<char,std::char_traits<char>,std::allocator<char> > &,std::basic_string<char,std::char_traits<char>,std::allocator<char> > *,int>' : identifier was truncated to '255' characters in the debug information
c:\program files\microsoft visual studio\vc98\include\vector(39) : while compiling class-template member function '__thiscall std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<c
har,std::char_traits<char>,std::allocator<char> > > >::std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > > >(const std::allocator<std:
:basic_string<char,std::char_traits<char>,std::allocator<char> > > &)'
Generating Code...
c:\program files\microsoft visual studio\vc98\include\vector(39) : warning C4786: 'std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > >
>::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > > >' : identifier was truncated to '255' characters in the debug information
c:\program files\microsoft visual studio\vc98\include\vector(60) : warning C4786: 'std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > >
>::~vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > > >' : identifier was truncated to '255' characters in the debug information
c:\program files\microsoft visual studio\vc98\include\vector(52) : warning C4786: 'std::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > >
>::vector<std::basic_string<char,std::char_traits<char>,std::allocator<char> >,std::allocator<std::basic_string<char,std::char_traits<char>,std::allocator<char> > > >' : identifier was truncated to '255' characters in the debug information

Do you know how can I get rid of theses warnings?

Thank you a lot.
GeneralRe: Warnings.... Pin
Adam Clauss7-May-04 4:50
Adam Clauss7-May-04 4:50 
GeneralWhy not use API Function GetPrivateProfileString Pin
Anonymous23-Mar-04 15:43
Anonymous23-Mar-04 15:43 
GeneralRe: Why not use API Function GetPrivateProfileString Pin
Adam Clauss23-Mar-04 15:48
Adam Clauss23-Mar-04 15:48 
GeneralMissing syncronization Pin
yokosuna28-Jan-04 0:19
yokosuna28-Jan-04 0:19 
Generalmy build error Pin
kjessee31-Oct-03 17:35
kjessee31-Oct-03 17:35 
GeneralRe: my build error Pin
Adam Clauss31-Oct-03 17:56
Adam Clauss31-Oct-03 17:56 
GeneralRe: my build error Pin
kjessee31-Oct-03 18:42
kjessee31-Oct-03 18:42 
GeneralGetNumKeys() Pin
codelion29-Sep-03 7:18
codelion29-Sep-03 7:18 
GeneralRe: GetNumValues() Pin
Adam Clauss29-Sep-03 8:36
Adam Clauss29-Sep-03 8:36 
GeneralSuggestions Pin
Egi4-Sep-03 22:49
Egi4-Sep-03 22:49 
GeneralSuggestions to get rid of warnings Pin
Anonymous7-Jun-03 2:28
Anonymous7-Jun-03 2:28 
QuestionHow to convert std:string and MFC:CString? Pin
Member 39523924-May-03 2:46
Member 39523924-May-03 2:46 
AnswerRe: How to convert std:string and MFC:CString? Pin
Adam Clauss24-May-03 3:04
Adam Clauss24-May-03 3:04 
GeneralBuild error Pin
dushkin10-May-03 23:04
dushkin10-May-03 23:04 
GeneralRe: Build error Pin
Adam Clauss11-May-03 5:34
Adam Clauss11-May-03 5:34 
GeneralGreat! Thanks a lot !! Pin
DonGuitar9-May-03 11:20
DonGuitar9-May-03 11:20 
GeneralCIniFile class giving me "Unresolved External" errors Pin
tuz23-Apr-03 16:41
tuz23-Apr-03 16:41 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.