mirror of
https://github.com/libretro/scummvm.git
synced 2025-02-05 18:41:12 +00:00
ec24687ce4
Adding @defgroup and @ingroup doxygen tags into all headers in the common folder that contain doxygen blocks. This improves the structure, readability, and findability of information in the resulting output. This commit targets purely structure and does not deal with the content of the currently existing doxygen documentation.
146 lines
4.2 KiB
C++
146 lines
4.2 KiB
C++
/* ScummVM - Graphic Adventure Engine
|
|
*
|
|
* ScummVM is the legal property of its developers, whose names
|
|
* are too numerous to list here. Please refer to the COPYRIGHT
|
|
* file distributed with this source distribution.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* 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; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*
|
|
*/
|
|
|
|
#ifndef COMMON_INI_FILE_H
|
|
#define COMMON_INI_FILE_H
|
|
|
|
#include "common/hash-str.h"
|
|
#include "common/list.h"
|
|
#include "common/str.h"
|
|
|
|
namespace Common {
|
|
|
|
/**
|
|
* @defgroup common_ini_file INI files
|
|
* @ingroup common
|
|
*
|
|
* @brief API for operations on INI configuration files.
|
|
*
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
class SeekableReadStream;
|
|
class WriteStream;
|
|
|
|
/**
|
|
* This class allows reading/writing INI style config files.
|
|
*
|
|
* Lines starting with a '#' are ignored (i.e. treated as comments).
|
|
* Some effort is made to preserve comments, though.
|
|
*
|
|
* This class makes no attempts to provide fast access to key/value pairs.
|
|
* In particular, it stores all sections and k/v pairs in lists, not
|
|
* in dictionaries/maps. This makes it very easy to read/write the data
|
|
* from/to files, but of course is not appropriate for fast access.
|
|
* The main reason is that this class is indeed geared toward doing precisely
|
|
* that!
|
|
*/
|
|
class INIFile {
|
|
public:
|
|
struct KeyValue {
|
|
String key;
|
|
String value;
|
|
String comment;
|
|
};
|
|
|
|
typedef List<KeyValue> SectionKeyList;
|
|
|
|
/** A section in a ini file. I.e. corresponds to something like this:
|
|
* [mySection]
|
|
* key=value
|
|
*
|
|
* Comments are also stored, to keep users happy who like editing their
|
|
* ini files manually.
|
|
*/
|
|
struct Section {
|
|
String name;
|
|
List<KeyValue> keys;
|
|
String comment;
|
|
|
|
bool hasKey(const String &key) const;
|
|
const KeyValue* getKey(const String &key) const;
|
|
void setKey(const String &key, const String &value);
|
|
void removeKey(const String &key);
|
|
const SectionKeyList getKeys() const { return keys; }
|
|
};
|
|
|
|
typedef List<Section> SectionList;
|
|
|
|
public:
|
|
INIFile();
|
|
~INIFile() {}
|
|
|
|
// TODO: Maybe add a copy constructor etc.?
|
|
|
|
/**
|
|
* Check whether the given string is a valid section or key name.
|
|
* For that, it must only consist of letters, numbers, dashes and
|
|
* underscores. In particular, white space and "#", "=", "[", "]"
|
|
* are not valid!
|
|
*/
|
|
bool isValidName(const String &name) const;
|
|
|
|
/** Reset everything stored in this ini file. */
|
|
void clear();
|
|
|
|
bool loadFromFile(const String &filename);
|
|
bool loadFromSaveFile(const String &filename);
|
|
bool loadFromStream(SeekableReadStream &stream);
|
|
bool saveToFile(const String &filename);
|
|
bool saveToSaveFile(const String &filename);
|
|
bool saveToStream(WriteStream &stream);
|
|
|
|
bool hasSection(const String §ion) const;
|
|
void addSection(const String §ion);
|
|
void removeSection(const String §ion);
|
|
void renameSection(const String &oldName, const String &newName);
|
|
|
|
void setDefaultSectionName(const String &name); ///< sets initial section name for section-less ini files
|
|
|
|
bool hasKey(const String &key, const String §ion) const;
|
|
bool getKey(const String &key, const String §ion, String &value) const;
|
|
void setKey(const String &key, const String §ion, const String &value);
|
|
void removeKey(const String &key, const String §ion);
|
|
|
|
const SectionList getSections() const { return _sections; }
|
|
const SectionKeyList getKeys(const String §ion) const;
|
|
|
|
void listKeyValues(StringMap &kv);
|
|
|
|
void allowNonEnglishCharacters();
|
|
|
|
private:
|
|
String _defaultSectionName;
|
|
SectionList _sections;
|
|
bool _allowNonEnglishCharacters;
|
|
|
|
Section *getSection(const String §ion);
|
|
const Section *getSection(const String §ion) const;
|
|
};
|
|
|
|
/** @} */
|
|
|
|
} // End of namespace Common
|
|
|
|
#endif
|