summaryrefslogtreecommitdiffstats
path: root/src/UiGuiIniFileParser.cpp
blob: e690139a257a3c573e12e166c1bf8247ea29f2d5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
/***************************************************************************
 *   Copyright (C) 2006-2012 by Thomas Schweitzer                          *
 *   thomas-schweitzer(at)arcor.de                                         *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License version 2.0 as   *
 *   published by the Free Software Foundation.                            *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program in the file LICENSE.GPL; if not, write to the *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/

#include "UiGuiIniFileParser.h"

#include <tntqfile.h>
#include <tntqstringlist.h>
#include <tntqvariant.h>
#include <tntqtextstream.h>

//! \defgroup grp_Settings All concerning applications settings.

/*!
    \class UiGuiIniFileParser
    \ingroup grp_Settings
    \brief UiGuiIniFileParser is a simple ini file format parser.

    These ini files need to have key-value pairs in the style
    "keyname=keyvalue". Groups can be defined by writing the groupname
    in the style [groupname] before some key-value pairs.

    The reason why I use my own class instead of TQSettings is mainly, that
    TQSettings always internally sorts the groups alphabetically and also
    rewrites a settings file sorted. Very annoying for me.
*/

/*!
    \brief Init and empty all needed lists and strings.
 */
UiGuiIniFileParser::UiGuiIniFileParser(void)
{
	init();
}

/*!
    \brief Directly loads and parses the file with name \a iniFileName.
 */
UiGuiIniFileParser::UiGuiIniFileParser(const TQString &iniFileName)
{
	init();
	_iniFileName = iniFileName;
	parseIniFile();
}

void UiGuiIniFileParser::init()
{
	_sections.clear();
	_keyValueMap.clear();
	_iniFileName = "";
}

UiGuiIniFileParser::~UiGuiIniFileParser(void)
{
}

/*!
    \brief Returns the group/section names in the same order as they occurr in the ini file as TQStringList.
 */
TQStringList UiGuiIniFileParser::childGroups()
{
	TQStringList sectionsStringList;

	for (unsigned int i = 0; i < _sections.size(); i++)
	{
		sectionsStringList << _sections[i];
	}

	return sectionsStringList;
}

/*!
    \brief Returns the value of the defined \a keyName as TQVariant.

    The \a keyName is assembled by a section name, a slash and the key name itself.
    For example if you wish to access the value of the following setting:
    <code>[NiceSection]</br>niceKeyName=2</code> you would have to call
    value("NiceSection/niceKeyName").
 */
TQVariant UiGuiIniFileParser::value(const TQString &keyName, const TQString &defaultValue)
{
	return _keyValueMap.value(keyName, defaultValue);
}

/*!
    \brief Parses the ini file and stores the key value pairs in the internal vectors \a keys and \a values.
 */
void UiGuiIniFileParser::parseIniFile()
{
	TQFile iniFile(_iniFileName);

	if (iniFile.open(TQFile::ReadOnly))
	{
		// Clear the vectors holding the keys and values.
		_sections.clear();
		_keyValueMap.clear();

		TQTextStream iniFileStream(&iniFile);
		TQString     line;
		TQString     currentSectionName = "";
		TQString     keyName       = "";
		TQString     valueAsString = "";

		while (!iniFileStream.atEnd())
		{
			line = iniFileStream.readLine().trimmed();

			// Test if the read line is a section name and if so remeber it.
			if (line.startsWith("[") && line.endsWith("]"))
			{
				currentSectionName = line.remove(0, 1);
				currentSectionName.chop(1);

				// Store the section name.
				_sections.push_back(currentSectionName);
			}
			// Otherwise test whether the line has a assign char
			else if (line.contains("="))
			{
				int indexOfFirstAssign = line.indexOf("=");
				keyName = line.left(indexOfFirstAssign);

				if (!keyName.isEmpty())
				{
					valueAsString = line.remove(0, indexOfFirstAssign + 1);
					// Remove any existing double quotes from the value.
					if (valueAsString.startsWith("\"") && valueAsString.endsWith("\""))
					{
						valueAsString = valueAsString.remove(0, 1);
						valueAsString.chop(1);
					}

					// Prepend an eventually section name to the key name.
					if (!currentSectionName.isEmpty())
					{
						keyName = currentSectionName + "/" + keyName;
					}

					// Store the key and value in the map.
					_keyValueMap.insert(keyName, valueAsString);
				}
			}
		}
	}
}