Click here to Skip to main content
11,707,254 members (48,295 online)
Click here to Skip to main content

Read and Write application parameters in XML

, 30 Jun 2003 603.2K 6K 138
Rate this:
Please Sign up or sign in to vote.
This article provides an easy way to load and save the parameters of an application in XML format.

Sample Image - maximum width is 600 pixels

<!------------------------------- STEP 3 ---------------------------><!-- Add the article text. Please use simple formatting (

,

etc) -->

Introduction

This article provides an easy way to load and save the parameters of an application in XML format.

XML is a convenient format to deal with the parameters of applications for the following reasons:

  • It's text, so you can easily check the values and modify them with a classical editor (by the way, IE 5.0 shows XML in a very nice way).
  • It's based on a tree so you can have your parameters saved in a structured way.
  • It's platform and language independent.
My goal was not to parse an XML file, but to give an easy way to read and write the data. So the code is based on A simple STL based XML parser by David Hubbard. I would really like to thank him for his parser, it's a very good work! Moreover it saved me a lot of time, even if I made a few modifications in his original code to fulfill my goals.

The code is entirely based on STL. It compiles on linux, too. I guess it will compile on any other platform/compiler that supports STL.

Using the code

Now let's take an example to explain more precisely what you can do with ParamIO. Let's assume you have an application to show some text on the screen in a given color and in a given font (the demo project). The parameters of your application will be the text (1 string), the color (3 values RGB) and the font (1 string for the font name and 1 double for the font size). You want to be able to save those parameters on the disk and load them for a later use. A nice XML file containing those values can look like this:

<PARAMS>
  <TEXT>Hello world</TEXT>
  <COLOR>
	<RED>50</RED>
	<GREEN>128</GREEN>
	<BLUE>255</BLUE>
  </COLOR>
  <FONT>
	<NAME>Arial</NAME>
	<SIZE>12.0</SIZE>
  </FONT>
</PARAMS>
Let's say we have the following variables in the application :
std::string _text;                 // The text
int _red, _green, _blue;           // color
std::string _fontName;             // font name
double _fontSize;                  // font size
The code to write the previous file will be :
ParamIO outXml;

outXml.write("PARAMS:TEXT", _text);

outXml.write("PARAMS:COLOR:RED",   _red);
outXml.write("PARAMS:COLOR:GREEN", _green);
outXml.write("PARAMS:COLOR:BLUE",  _blue);

outXml.write("PARAMS:FONT:NAME", _fontName);
outXml.write("PARAMS:FONT:SIZE", _fontSize);

outXml.writeFile("filename.xml"); // Finally write the file to disk
As you can see, it's very easy. In the write method, the first parameter is a char* that defines the position in the XML tree. This is similar to XPath, but I didn't know XPath at the time I wrote this code, I would have used the '/' instead if I had known. The second parameter gives the value you want to write. write is a templated method so you can write almost any kind of variable, from int to std::string. Reading the file is also straightforward :
ParamIO inXml;

inXml.readFile("filename.xml"); // Read the file from disk

inXml.read("PARAMS:TEXT", _text, std::string("Hello world"));

inXml.read("PARAMS:COLOR:RED",   _red,   0);
inXml.read("PARAMS:COLOR:GREEN", _green, 0);
inXml.read("PARAMS:COLOR:BLUE",  _blue,  0);

inXml.read("PARAMS:FONT:NAME", _fontName, std::string("Arial"));
inXml.read("PARAMS:FONT:SIZE", _fontSize, 12.0);
You may be surprised by the third parameter of the read method. What does it mean? It's the default value of the parameter you try to read. Imagine you want to read a file like the previous one and the size of the font is not specified, then _fontSize will be automatically set to its default value 12.0. It's a very useful behaviour when you have several versions of a same application and some versions have parameters that didn't exist in older ones. It ensures that you still can read the old files, filling the missing values with default ones. It also lets you load a file that doesn't exist and set all the parameters with their default values.

ParamIO lets you read and write XML coming from streams also, it should be useful if you want some applications to exchange data through sockets for example.

The demo application includes a XML dialog box. With this dialog box (CXML_Dialog), you can visualise and modify any XML tree. I used it a lot, it's working really well. In case your parameter name contains FILENAME inside (e.g FONT_FILENAME), you'll see a button appear, and if you click on it, you'll obtain an open file dialog where you can find your file. I used this CXML_Dialog dialog box a lot and I'm very happy about it, it works really fine. CXML_Dialog uses a class from Easy Navigation Through an Editable List View by Lee Nowotny. I really thank him for the job, it works perfectly.

If you have any comments, suggestions or improvements let me know.

History

20 Nov 2002 : first version with GUI demo, with comparison capabilities

20 June 2003:

  • modified the website, added src download without the GUI demo
  • Added support for MFC CString has been added thanks to Paul Kissel : to enable CString read/write, just define _PARAMIO_CSTRING_SUPPORT_ in the compilation options.
  • Added a method to erase a node or an entire subtree as been added, thanks to Ogi's suggestion.

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

Share

About the Author

Arnaud Brejeon
Web Developer
China China
I've been living & working in Tokyo since 2000 . I'm currently working in Gentech Corp. (www.gen.co.jp), developing computer vision applications, especially in the field of face detection.

I've been interested in C++ for quite a while and recently discovered Ruby.

My hobbies are trekking, japanese food, yoga & onsens.

You may also be interested in...

Comments and Discussions

 
GeneralRe: Update Pin
deukath5-Aug-03 5:23
memberdeukath5-Aug-03 5:23 
QuestionHow to remove a tag? Pin
Ogi12-Jun-03 4:10
memberOgi12-Jun-03 4:10 
AnswerRe: How to remove a tag? Pin
Ogi17-Jun-03 0:47
memberOgi17-Jun-03 0:47 
GeneralRe: How to remove a tag? Pin
Arnaud Brejeon18-Jun-03 16:46
memberArnaud Brejeon18-Jun-03 16:46 
GeneralProblems with MFC and ParamIO Pin
Andy@4-Jun-03 2:01
memberAndy@4-Jun-03 2:01 
GeneralRe: Problems with MFC and ParamIO Pin
Arnaud Brejeon4-Jun-03 15:00
memberArnaud Brejeon4-Jun-03 15:00 
GeneralRe: Problems with MFC and ParamIO Pin
Andy@4-Jun-03 20:03
memberAndy@4-Jun-03 20:03 
Hi,

i use VC++ 6.
The errors are the followings:

nafxcwd.lib(afxmem.obj) : error LNK2005: "void * __cdecl operator new(unsigned int)" (??2@YAPAXI@Z) bereits in LIBCMTD.lib(new.obj) definiert
nafxcwd.lib(afxmem.obj) : error LNK2005: "void __cdecl operator delete(void *)" (??3@YAXPAX@Z) bereits in libcpmtd.lib(delop.obj) definiert
Debug/TestParamIO.exe : fatal error LNK1169: Ein oder mehrere mehrfach definierte Symbole gefunden

It says that "void * __cdecl operator new(unsigned int)" and "void __cdecl operator delete(void *)" are already defined in LIBCMTD.lib.

How can i use another STL with VC++?

Andy
GeneralRe: Problems with MFC and ParamIO Pin
Paul Kissel13-Jun-03 12:09
memberPaul Kissel13-Jun-03 12:09 
GeneralRe: Problems with MFC and ParamIO Pin
Andy@15-Jun-03 20:24
memberAndy@15-Jun-03 20:24 
GeneralRe: Problems with MFC and ParamIO Pin
Arnaud Brejeon15-Jun-03 21:06
memberArnaud Brejeon15-Jun-03 21:06 
GeneralRe: Problems with MFC and ParamIO Pin
Paul Kissel15-Jun-03 22:14
memberPaul Kissel15-Jun-03 22:14 
GeneralRe: Problems with MFC and ParamIO Pin
Andy@15-Jun-03 23:27
memberAndy@15-Jun-03 23:27 
GeneralRe: Problems with MFC and ParamIO Pin
Paul Kissel16-Jun-03 7:28
memberPaul Kissel16-Jun-03 7:28 
GeneralRe: Problems with MFC and ParamIO Pin
Andy@16-Jun-03 20:16
memberAndy@16-Jun-03 20:16 
GeneralRe: Problems with MFC and ParamIO Pin
Paul Kissel16-Jun-03 20:32
memberPaul Kissel16-Jun-03 20:32 
GeneralRe: Problems with MFC and ParamIO Pin
Arnaud Brejeon16-Jun-03 20:42
memberArnaud Brejeon16-Jun-03 20:42 
GeneralRe: Problems with MFC and ParamIO Pin
Paul Kissel17-Jun-03 14:14
memberPaul Kissel17-Jun-03 14:14 
Generalcompile problem with vc .net Pin
VinZ12-May-03 22:08
memberVinZ12-May-03 22:08 
GeneralRe: compile problem with vc .net Pin
VinZ12-May-03 23:51
memberVinZ12-May-03 23:51 
GeneralCompile Errors VC++ 6.0 SP5 Pin
ClickHeRe9-Apr-03 12:38
memberClickHeRe9-Apr-03 12:38 
QuestionAttribute Support? Pin
Daryl Forrest24-Feb-03 7:18
memberDaryl Forrest24-Feb-03 7:18 
AnswerRe: Attribute Support? Pin
Paul Kissel17-Jun-03 15:11
memberPaul Kissel17-Jun-03 15:11 
Questionread duplicate XML tags? Pin
krustychang10-Feb-03 10:20
memberkrustychang10-Feb-03 10:20 
AnswerRe: read duplicate XML tags? Pin
glowy24-Jun-03 4:50
memberglowy24-Jun-03 4:50 
Generalusing paramIO Pin
ww_dotnet3-Feb-03 20:42
memberww_dotnet3-Feb-03 20:42 
GeneralRe: using paramIO Pin
Arnaud Brejeon4-Feb-03 19:39
memberArnaud Brejeon4-Feb-03 19:39 
GeneralRe: using paramIO Pin
Anonymous6-Feb-03 8:15
sussAnonymous6-Feb-03 8:15 
GeneralRe: using paramIO Pin
Adi Shavit26-May-03 1:57
memberAdi Shavit26-May-03 1:57 
GeneralRe: using paramIO Pin
Andy@3-Jun-03 3:05
memberAndy@3-Jun-03 3:05 
GeneralRe: using paramIO Pin
Adi Shavit3-Jun-03 3:29
memberAdi Shavit3-Jun-03 3:29 
GeneralRe: using paramIO Pin
Andy@3-Jun-03 4:20
memberAndy@3-Jun-03 4:20 
GeneralRe: using paramIO Pin
Andy@3-Jun-03 20:56
memberAndy@3-Jun-03 20:56 
QuestionHow can I read? Pin
marco.song20-Dec-02 5:50
membermarco.song20-Dec-02 5:50 
Generalmaybe have a bug. Pin
marco.song14-Dec-02 5:45
membermarco.song14-Dec-02 5:45 
GeneralRe: maybe have a bug. Pin
Arnaud Brejeon18-Dec-02 14:51
memberArnaud Brejeon18-Dec-02 14:51 
GeneralEnhancement Idea Pin
Loren Brewer22-Nov-02 9:08
memberLoren Brewer22-Nov-02 9:08 
GeneralRe: Enhancement Idea Pin
Arnaud Brejeon24-Nov-02 17:21
memberArnaud Brejeon24-Nov-02 17:21 
GeneralRe: Enhancement Idea Pin
Neville Franks25-Nov-02 10:10
memberNeville Franks25-Nov-02 10:10 
GeneralRe: Enhancement Idea Pin
Arnaud Brejeon25-Nov-02 17:32
memberArnaud Brejeon25-Nov-02 17:32 
GeneralRe: Enhancement Idea Pin
Loren Brewer26-Nov-02 7:37
memberLoren Brewer26-Nov-02 7:37 
GeneralRe: Enhancement Idea Pin
Neville Franks26-Nov-02 14:28
memberNeville Franks26-Nov-02 14:28 
GeneralComments Pin
Loren Brewer21-Nov-02 10:24
memberLoren Brewer21-Nov-02 10:24 
GeneralXML Editor Pin
doron21-Nov-02 2:56
memberdoron21-Nov-02 2:56 
GeneralRe: XML Editor Pin
Nitron10-Jan-03 13:36
memberNitron10-Jan-03 13:36 
GeneralTabs Pin
Loren Brewer14-Nov-02 19:56
memberLoren Brewer14-Nov-02 19:56 
GeneralRe: Tabs Pin
Neville Franks25-Nov-02 10:19
memberNeville Franks25-Nov-02 10:19 
GeneralRe: Tabs Pin
Arnaud Brejeon25-Nov-02 17:36
memberArnaud Brejeon25-Nov-02 17:36 
GeneralRe: Tabs Pin
Loren Brewer26-Nov-02 7:33
memberLoren Brewer26-Nov-02 7:33 
GeneralRe: Tabs Pin
Neville Franks26-Nov-02 14:25
memberNeville Franks26-Nov-02 14:25 
GeneralVS.NET compile errors Pin
Anonymous27-Oct-02 15:21
sussAnonymous27-Oct-02 15:21 

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

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

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150819.1 | Last Updated 1 Jul 2003
Article Copyright 2001 by Arnaud Brejeon
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid