/usr/include/unity/util/IniParser.h is in libunity-api-dev 7.108+16.04.20160322-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
* Copyright (C) 2013 Canonical Ltd
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 3 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Authored by: Jussi Pakkanen <jussi.pakkanen@canonical.com>
*/
#ifndef UNITY_UTIL_INIPARSER_H
#define UNITY_UTIL_INIPARSER_H
#include <unity/SymbolExport.h>
#include <unity/util/DefinesPtrs.h>
#include<string>
#include<vector>
namespace unity
{
namespace util
{
namespace internal
{
struct IniParserPrivate;
}
/**
\brief Helper class to read configuration files.
This class reads configuration files in the .ini format
and provides for a simple and type safe way of extracting
information. A typical ini file looks like this:
~~~
[group1]
key1 = value1
key2 = value2
[group2]
key1 = othervalue1
key2 = othervalue2
~~~
To obtain a value, simply specify the group and key names to
the get* functions of this class. The array functions use
a semicolon as a separator.
The get functions indicate errors by throwing LogicExceptions.
Examples why this might happen is because a value can't be
coerced into the given type (i.e trying to convert the value
"hello" into a boolean).
*/
class UNITY_API IniParser final {
public:
/** Parse the given file. */
IniParser(const char* filename);
~IniParser() noexcept;
/// @cond
UNITY_DEFINES_PTRS(IniParser);
IniParser(const IniParser& ip) = delete;
IniParser() = delete;
/// @endcond
/** @name Accessors
* These member functions provide access to configuration entries by group and key.
* Attempts to retrieve a value as the wrong type, such as retrieving a string value
* "abc" as an integer, throw LogicException.
**/
//{@
bool has_group(const std::string& group) const noexcept;
bool has_key(const std::string& group, const std::string& key) const;
std::string get_string(const std::string& group, const std::string& key) const;
std::string get_locale_string(const std::string& group,
const std::string& key,
const std::string& locale = std::string()) const;
bool get_boolean(const std::string& group, const std::string& key) const;
int get_int(const std::string& group, const std::string& key) const;
std::vector<std::string> get_string_array(const std::string& group, const std::string& key) const;
std::vector<std::string> get_locale_string_array(const std::string& group,
const std::string& key,
const std::string& locale = std::string()) const;
std::vector<int> get_int_array(const std::string& group, const std::string& key) const;
std::vector<bool> get_boolean_array(const std::string& group, const std::string& key) const;
std::string get_start_group() const;
std::vector<std::string> get_groups() const;
std::vector<std::string> get_keys(const std::string& group) const;
//@}
private:
internal::IniParserPrivate* p;
};
} // namespace util
} // namespace unity
#endif
|