You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
873 lines
25 KiB
873 lines
25 KiB
/**
|
|
* @file ISettingsProvider.h
|
|
* @brief Settings provider interface.
|
|
* @copyright VisionLabs LLC
|
|
* @date 06.11.2015
|
|
* */
|
|
|
|
#pragma once
|
|
|
|
#include <fsdk/IObject.h>
|
|
#include <fsdk/Types.h>
|
|
#include "FSDKError.h"
|
|
#include <cstring>
|
|
#include <string>
|
|
|
|
namespace fsdk {
|
|
|
|
#ifndef DOXYGEN_SHOULD_SKIP_THIS
|
|
DECLARE_SMARTPTR(ISettingsProvider);
|
|
#endif
|
|
|
|
/**
|
|
* @addtogroup CoreGroup SDK core interfaces
|
|
* @brief Common interfaces and macros shared across all SDK objects.
|
|
* @{
|
|
* */
|
|
|
|
/**
|
|
* @brief SDK settings provider interface.
|
|
* @details Takes care of loading and parsing of SDK configuration files.
|
|
* */
|
|
struct FSDK_API ISettingsProvider : IRefCounted {
|
|
|
|
/**
|
|
* @brief Config parsing error codes.
|
|
* */
|
|
enum class Error : uint32_t {
|
|
Ok, //!< No error
|
|
IOError, //!< Error reading from file/stream
|
|
Memory, //!< Could not allocate memory
|
|
Internal, //!< Internal error occurred
|
|
InvalidPi, //!< Parsing error occurred while parsing document declaration/processing instruction
|
|
InvalidTag, //!< Parser could not determine tag type
|
|
InvalidCdata, //!< Parsing error occurred while parsing CDATA section
|
|
FileNotFound, //!< File was not found during load_file()
|
|
InvalidPcdata, //!< Parsing error occurred while parsing PCDATA section
|
|
InvalidDocType, //!< Parsing error occurred while parsing document type declaration
|
|
InvalidSettings, //!< Settings section is invalid or absent.
|
|
InvalidComment, //!< Parsing error occurred while parsing comment
|
|
InvalidAttribute, //!< Parsing error occurred while parsing element attribute
|
|
InvalidEndElement, //!< Parsing error occurred while parsing end element tag
|
|
AppendInvalidRoot, //!< Unable to append nodes since root type is not node_element or node_document (exclusive to xml_node::append_buffer)
|
|
NoDocumentElement, //!< Parsing resulted in a document without element nodes
|
|
EndElementMismatch, //!< There was a mismatch of start-end tags (closing tag had incorrect name, some tag was not closed or there was an excessive closing tag)
|
|
InvalidStartElement, //!< Parsing error occurred while parsing start element tag
|
|
MemoryAllocationFailed, //!< memory allocation failed for internal data
|
|
};
|
|
|
|
/**
|
|
* @brief Get settings path this provider is bound to.
|
|
* @details This is the same path that was given to load().
|
|
* @returns path string.
|
|
* */
|
|
virtual const char* getDefaultPath() const noexcept = 0;
|
|
|
|
/**
|
|
* @brief Load settings from given path.
|
|
* @details if `path` is null, load from the default path; @see getDefaultPath().
|
|
* @return Result with error code specified by ISettingsProvider::ParseError.
|
|
* @see Result and ISettingsProvider::ParseError.
|
|
* */
|
|
virtual Result<Error> load(const char* path) noexcept = 0;
|
|
|
|
/**
|
|
* @brief Save settings values using the default path.
|
|
* @details path may be null, in this case a path from getDefaultPath() will be used.
|
|
* @returns true if succeded, false otherwise.
|
|
* */
|
|
virtual bool save(const char* path) const noexcept = 0;
|
|
|
|
/**
|
|
* @brief Clear settings.
|
|
* @returns true if succeded, false otherwise.
|
|
* */
|
|
virtual void clear() noexcept = 0;
|
|
|
|
/**
|
|
* Check if there are loaded settings.
|
|
* @returns true if provider is empty.
|
|
* */
|
|
virtual bool isEmpty() const noexcept = 0;
|
|
|
|
|
|
/**
|
|
* @brief Configuration parameter value.
|
|
* */
|
|
struct FSDK_API Value {
|
|
|
|
/**
|
|
* @brief Value data.
|
|
* */
|
|
union Data {
|
|
struct Int1 { int m_value; } m_int1; //!< Data as integer.
|
|
struct Int2 { int m_value[2]; } m_int2; //!< Data as 2D integer.
|
|
struct Int3 { int m_value[3]; } m_int3; //!< Data as 3D integer.
|
|
struct Int4 { int m_value[4]; } m_int4; //!< Data as 4D integer.
|
|
struct Float1 { float m_value; } m_float1; //!< Data as float.
|
|
struct Float2 { float m_value[2]; } m_float2; //!< Data as 2D float.
|
|
struct Float3 { float m_value[3]; } m_float3; //!< Data as 3D float.
|
|
struct Float4 { float m_value[4]; } m_float4; //!< Data as 4D float.
|
|
struct String { char* m_value; } m_string; //!< Data as string.
|
|
} m_data; //!< Data storage.
|
|
|
|
/**
|
|
* @brief Value type.
|
|
* */
|
|
enum Type {
|
|
Undefined, //!< Unkown value type.
|
|
Int1, //!< Integer.
|
|
Int2, //!< 2D integer.
|
|
Int3, //!< 3D integer.
|
|
Int4, //!< 4D integer.
|
|
Float1, //!< floating point.
|
|
Float2, //!< 2D floating point.
|
|
Float3, //!< 3D floating point.
|
|
Float4, //!< 4D floating point.
|
|
String //!< Short string.
|
|
} m_type; //!< Data type..
|
|
|
|
/**
|
|
* @brief Initialize an empty value.
|
|
* @details Value type will be set to `Undefined`.
|
|
* */
|
|
Value() noexcept;
|
|
|
|
/**
|
|
* @brief Initialize an integer value.
|
|
* @param x integer value.
|
|
* */
|
|
Value(int x) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a 2d integer value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* */
|
|
Value(int x, int y) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a 3d integer value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* */
|
|
Value(int x, int y, int z) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a 4d integer value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* @param w 4th value.
|
|
* */
|
|
Value(int x, int y, int z, int w) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a float value.
|
|
* @param x float value.
|
|
* */
|
|
Value(float x) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a 2d float value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* */
|
|
Value(float x, float y) noexcept;
|
|
/**
|
|
* @brief Initialize a 3d float value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* */
|
|
Value(float x, float y, float z) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a 4d float value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* @param w 4th value.
|
|
* */
|
|
Value(float x, float y, float z, float w) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a string value.
|
|
* @note Only short strings (<64 chars) are supported.
|
|
* @param string string value.
|
|
* */
|
|
Value(const char* string) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a rect value.
|
|
* @param rect rect value.
|
|
* */
|
|
Value(const Rect& rect) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a size value.
|
|
* @param size size value.
|
|
* */
|
|
Value(const Size& size) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a point value.
|
|
* @param point point value.
|
|
* */
|
|
Value(const Point2f& point) noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a bool value.
|
|
* @param x bool value.
|
|
* */
|
|
Value(bool x) noexcept;
|
|
|
|
/**
|
|
* @brief Check if value type is not `Undefined`.
|
|
* @returns true if value type is not `Undefined`.
|
|
* */
|
|
operator bool() const noexcept;
|
|
|
|
/**
|
|
* @brief Check if value type is of concrete type.
|
|
* @param type type to check.
|
|
* @returns true if value type is equal to `type`.
|
|
* */
|
|
bool is(Type type) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a string value.
|
|
* @param string the value.
|
|
* */
|
|
bool setString(const char* string) noexcept;
|
|
|
|
/**
|
|
* @brief Get a string value.
|
|
* @param [out] string the value.
|
|
* @note function fails if actual value type is not string; in this case `string` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getString(char* string) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a rect value.
|
|
* @param rect the value.
|
|
* */
|
|
void setRect(const Rect& rect) noexcept;
|
|
|
|
/**
|
|
* @brief Get a rect value.
|
|
* @param [out] rect the value.
|
|
* @note function fails if actual value type is not convertible to rect; in this case `rect` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getRect(Rect* rect) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a size value.
|
|
* @param size the value.
|
|
* */
|
|
void setSize(const Size& size) noexcept;
|
|
|
|
/**
|
|
* @brief Get a size value.
|
|
* @param [out] size the value.
|
|
* @note function fails if actual value type is not convertible to size; in this case `size` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getSize(Size* size) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a Point2i value.
|
|
* @param point the value.
|
|
* */
|
|
void setPoint2i(const Point2i& point) noexcept;
|
|
|
|
/**
|
|
* @brief Get a Point2i value.
|
|
* @param [out] point the value.
|
|
* @note function fails if actual value type is not convertible to Point2i; in this case `point` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getPoint2i(Point2i* point) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a setPoint2f value.
|
|
* @param point the value.
|
|
* */
|
|
void setPoint2f(const Point2f& point) noexcept;
|
|
|
|
/**
|
|
* @brief Get a Point2f value.
|
|
* @param [out] point the value.
|
|
* @note function fails if actual value type is not convertible to Point2f; in this case `point` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getPoint2f(Point2f* point) const noexcept;
|
|
|
|
/**
|
|
* @brief Set a bool value.
|
|
* @param x the value.
|
|
* */
|
|
void setBool(bool x) noexcept;
|
|
|
|
/**
|
|
* @brief Get a bool value.
|
|
* @param [out] x the value.
|
|
* @note function fails if actual value type is not convertible to bool; in this case `x` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getBool(bool* x) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set an int value.
|
|
* @param x the value.
|
|
* */
|
|
void setInt(int x) noexcept;
|
|
|
|
/**
|
|
* @brief Get an int value.
|
|
* @param [out] x the value.
|
|
* @note function fails if actual value type is not an int; in this case `x` isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getInt(int* x) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a 2d int value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* */
|
|
void setInt(int x, int y) noexcept;
|
|
|
|
/**
|
|
* @brief Get a 2d int value.
|
|
* @param [out] x 1st value.
|
|
* @param [out] y 2nd value.
|
|
* @note function fails if actual value type is not a 2d int; in this case output parameters aren't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getInt(int* x, int* y) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a 3d int value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* */
|
|
void setInt(int x, int y, int z) noexcept;
|
|
|
|
/**
|
|
* @brief Get a 3d int value.
|
|
* @param [out] x 1st value.
|
|
* @param [out] y 2nd value.
|
|
* @param [out] z 3rd value.
|
|
* @note function fails if actual value type is not a 3d int; in this case output parameters aren't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getInt(int* x, int* y, int* z) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a 4d int value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* @param w 4th value.
|
|
* */
|
|
void setInt(int x, int y, int z, int w) noexcept;
|
|
|
|
/**
|
|
* @brief Get a 4d int value.
|
|
* @param [out] x 1st value.
|
|
* @param [out] y 2nd value.
|
|
* @param [out] z 3rd value.
|
|
* @param [out] w 4th value.
|
|
* @note function fails if actual value type is not a 4d int; in this case output parameters aren't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getInt(int* x, int* y, int* z, int* w) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a float value.
|
|
* @param x the value.
|
|
* */
|
|
void setFloat(float x) noexcept;
|
|
|
|
/**
|
|
* @brief Get a float value.
|
|
* @param [out] x the value.
|
|
* @note function fails if actual value type is not a float; in this case 'x' isn't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getFloat(float* x) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a 2d float value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* */
|
|
void setFloat(float x, float y) noexcept;
|
|
|
|
/**
|
|
* @brief Get a 2d float value.
|
|
* @param [out] x 1st value.
|
|
* @param [out] y 2nd value.
|
|
* @note function fails if actual value type is not a 2d float; in this case output parameters aren't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getFloat(float* x, float* y) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a 3d float value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* */
|
|
void setFloat(float x, float y, float z) noexcept;
|
|
|
|
/**
|
|
* @brief Get a 3d float value.
|
|
* @param [out] x 1st value.
|
|
* @param [out] y 2nd value.
|
|
* @param [out] z 3rd value.
|
|
* @note function fails if actual value type is not a 3d float; in this case output parameters aren't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getFloat(float* x, float* y, float* z) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Set a 4d float value.
|
|
* @param x 1st value.
|
|
* @param y 2nd value.
|
|
* @param z 3rd value.
|
|
* @param w 4th value.
|
|
* */
|
|
void setFloat(float x, float y, float z, float w) noexcept;
|
|
|
|
/**
|
|
* @brief Get a 4d float value.
|
|
* @param [out] x 1st value.
|
|
* @param [out] y 2nd value.
|
|
* @param [out] z 3rd value.
|
|
* @param [out] w 4th value.
|
|
* @note function fails if actual value type is not a 4d float; in this case output parameters aren't modified.
|
|
* @returns true if succeeded; false otherwise.
|
|
* */
|
|
bool getFloat(float* x, float* y, float* z, float* w) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a float.
|
|
* @details If actual value type is float, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
float asFloat(float defaultValue = 0.f) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a Point2f.
|
|
* @details If actual value type is convertible to Point2f, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
Point2f asPoint2f(const Point2f& defaultValue = Point2f()) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a boolean.
|
|
* @details If actual value type is convertible to bool, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
bool asBool(bool defaultValue = false) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get an integer.
|
|
* @details If actual value type is Int, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
int asInt(int defaultValue = 0) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a Size.
|
|
* @details If actual value type is convertible to Size, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
Size asSize(const Size& defaultValue = Size()) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a Point2i.
|
|
* @details If actual value type is convertible to Point2i, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
Point2i asPoint2i(const Point2i& defaultValue = Point2i()) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a Rect.
|
|
* @details If actual value type is convertible to Rect, the value is returned; if not a fallback value is returned.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
Rect asRect(const Rect& defaultValue = Rect()) const noexcept;
|
|
|
|
|
|
/**
|
|
* @brief Safely get a string.
|
|
* @details If actual value type is String, the value is returned; if not a fallback value is returned.
|
|
* @note Doesn't allocate or copy memory.
|
|
* @param defaultValue fallback value (optional).
|
|
* @returns value.
|
|
* */
|
|
const char* asString(const char* defaultValue = "") const noexcept;
|
|
|
|
inline Value(const Value& other) = delete;
|
|
Value(Value&& other);
|
|
|
|
inline Value& operator=(const Value& other) = delete;
|
|
Value& operator=(Value&& other);
|
|
|
|
void swap(Value& first, Value& second);
|
|
|
|
~Value();
|
|
};
|
|
|
|
|
|
/** @brief Configuration parameter key. */
|
|
struct FSDK_API Key {
|
|
|
|
/** @brief Initialize an empty key. */
|
|
Key() noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a key.
|
|
* @param section section name.
|
|
* @param parameter parameter name.
|
|
* */
|
|
Key(const char* section, const char* parameter) noexcept;
|
|
|
|
/**
|
|
* @brief Get section name.
|
|
* @returns section name.
|
|
* */
|
|
const char* getSection() const noexcept;
|
|
|
|
/**
|
|
* @brief Get parameter name.
|
|
* @returns parameter name.
|
|
* */
|
|
const char* getParameter() const noexcept;
|
|
|
|
/**
|
|
* @brief Set section name.
|
|
* @param section section name.
|
|
* */
|
|
void setSection(const char* section) noexcept;
|
|
|
|
/**
|
|
* @brief Set parameter name.
|
|
* @param parameter parameter name.
|
|
* */
|
|
void setParameter(const char* parameter) noexcept;
|
|
|
|
/**
|
|
* @brief Operator `Less`.
|
|
* @param other other key.
|
|
* @returns comparison result.
|
|
* */
|
|
bool operator < (const ISettingsProvider::Key& other) const noexcept;
|
|
|
|
protected:
|
|
static const unsigned int m_bufferLength = 128;
|
|
char m_section [m_bufferLength]; //!< Config section name.
|
|
char m_parameter [m_bufferLength]; //!< Config parameter name.
|
|
};
|
|
|
|
|
|
/** @brief Configuration parameter description. */
|
|
struct FSDK_API Desc {
|
|
|
|
/** @brief Initialize an empty description. */
|
|
Desc() noexcept;
|
|
|
|
/**
|
|
* @brief Initialize a description.
|
|
* @param desc description text.
|
|
* */
|
|
Desc(const char* desc) noexcept;
|
|
|
|
/**
|
|
* @brief Get description text.
|
|
* @returns description text.
|
|
* */
|
|
const char* getDesc() const noexcept;
|
|
|
|
/**
|
|
* @brief Set description text.
|
|
* @param desc description text.
|
|
* */
|
|
void setDesc(const char* desc) noexcept;
|
|
|
|
protected:
|
|
static const unsigned int m_bufferLength = 256;
|
|
char m_desc [m_bufferLength]; //!< Parameter description text.
|
|
};
|
|
|
|
|
|
/** @brief Configuration parameter entry. */
|
|
struct FSDK_API Entry {
|
|
|
|
Value m_value; //!< Parameter value.
|
|
Desc m_desc; //!< Parameter description.
|
|
|
|
/** @brief Initialize an empty entry. */
|
|
Entry() noexcept = default;
|
|
|
|
Entry(Entry&& right);
|
|
|
|
Entry& operator=(Entry&& right);
|
|
|
|
void swap(Entry& first, Entry& second);
|
|
/**
|
|
* @brief Initialize an entry.
|
|
* @param desc description.
|
|
* @param value value.
|
|
* */
|
|
Entry(const Desc& desc, Value&& value) noexcept;
|
|
|
|
/**
|
|
* @brief Set description.
|
|
* @param desc description.
|
|
* */
|
|
void setDesc(const Desc& desc) noexcept;
|
|
|
|
/**
|
|
* @brief Set value.
|
|
* @param value value.
|
|
* */
|
|
void setValue(Value&& value) noexcept;
|
|
|
|
/**
|
|
* @brief Get description.
|
|
* @returns description.
|
|
* */
|
|
const Desc& getDesc() const noexcept;
|
|
|
|
/**
|
|
* @brief Get value.
|
|
* @returns value.
|
|
* */
|
|
const Value& getValue() const noexcept;
|
|
};
|
|
|
|
/**
|
|
* @brief Set parameter description.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param key parameter key.
|
|
* @param desc parameter description.
|
|
* */
|
|
virtual void setDesc(const Key& key, const Desc& desc) noexcept = 0;
|
|
|
|
/**
|
|
* @brief Set parameter description.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param section parameter section.
|
|
* @param parameter parameter name.
|
|
* @param desc parameter description.
|
|
* */
|
|
void setDesc(
|
|
const char* section,
|
|
const char* parameter,
|
|
const Desc& desc) noexcept;
|
|
|
|
/**
|
|
* @brief Set parameter value.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param key parameter key.
|
|
* @param value parameter value.
|
|
* */
|
|
virtual void setValue(const Key& key, Value&& value) noexcept = 0;
|
|
|
|
/**
|
|
* @brief Set parameter value.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param section parameter section.
|
|
* @param parameter parameter name.
|
|
* @param value parameter value.
|
|
* */
|
|
void setValue(
|
|
const char* section,
|
|
const char* parameter,
|
|
Value&& value) noexcept;
|
|
|
|
/**
|
|
* @brief Set parameter.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param key parameter key.
|
|
* @param entry parameter entry.
|
|
* */
|
|
virtual void setEntry(const Key& key, Entry&& entry) noexcept = 0;
|
|
|
|
/**
|
|
* @brief Set parameter.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param key parameter key.
|
|
* @param desc parameter description.
|
|
* @param value parameter value.
|
|
* */
|
|
void setEntry(
|
|
const Key& key,
|
|
const Desc& desc,
|
|
Value&& value) noexcept;
|
|
|
|
/**
|
|
* @brief Set parameter.
|
|
* @details Lookup parameter by key.
|
|
* Creates a parameter if it does not already exist.
|
|
* @param section parameter section.
|
|
* @param parameter parameter name.
|
|
* @param desc parameter description.
|
|
* @param value parameter value.
|
|
* */
|
|
void setEntry(
|
|
const char* section,
|
|
const char* parameter,
|
|
const Desc& desc,
|
|
Value&& value) noexcept;
|
|
|
|
/**
|
|
* @brief Find parameter entry.
|
|
* @details Lookup parameter by key.
|
|
* Return empty entry if the parameters does not exist.
|
|
* @param key parameter key.
|
|
* @returns parameter entry.
|
|
* */
|
|
virtual const Entry& getEntry(const Key& key) const noexcept = 0;
|
|
|
|
/**
|
|
* @brief Get parameter description.
|
|
* @details Lookup parameter by key.
|
|
* Return empty description if the parameters does not exist.
|
|
* @param key parameter key.
|
|
* @returns parameter description.
|
|
* */
|
|
Desc getDesc(const Key& key) const noexcept;
|
|
|
|
/**
|
|
* @brief Get parameter description.
|
|
* @details Lookup parameter by key.
|
|
* Return empty description if the parameters does not exist.
|
|
* @param section parameter section.
|
|
* @param parameter parameter name.
|
|
* @returns parameter description.
|
|
* */
|
|
Desc getDesc(const char* section, const char* parameter) const noexcept;
|
|
|
|
/**
|
|
* @brief Get parameter value.
|
|
* @details Lookup parameter by key.
|
|
* Return empty value if the parameters does not exist.
|
|
* @param key parameter key.
|
|
* @returns parameter value.
|
|
* */
|
|
const Value& getValue(const Key& key) const noexcept;
|
|
|
|
/**
|
|
* @brief Get parameter value.
|
|
* @details Lookup parameter by key.
|
|
* Return empty value if the parameters does not exist.
|
|
* @param section parameter section.
|
|
* @param parameter parameter name.
|
|
* @returns parameter value.
|
|
* */
|
|
const Value& getValue(const char* section, const char* parameter) const noexcept;
|
|
};
|
|
|
|
/**
|
|
* @brief Create a settings provider.
|
|
* @param [in] path configuration file path.
|
|
* @return settings provider object if succeeded, null if failed.
|
|
* */
|
|
FSDK_API fsdk::ResultValue<fsdk::FSDKError, fsdk::ISettingsProviderPtr>
|
|
createSettingsProvider(const char* path) noexcept;
|
|
/**
|
|
* @brief Specialized for ISettingsProvider::ParseError.
|
|
* */
|
|
template<>
|
|
struct ErrorTraits<ISettingsProvider::Error> {
|
|
|
|
static bool isOk(ISettingsProvider::Error error) noexcept {
|
|
return error == ISettingsProvider::Error::Ok;
|
|
}
|
|
|
|
static const char* toString (ISettingsProvider::Error error) noexcept {
|
|
switch(error) {
|
|
case ISettingsProvider::Error::Ok:
|
|
return "Ok";
|
|
case ISettingsProvider::Error::Memory:
|
|
return "Could not allocate memory";
|
|
case ISettingsProvider::Error::IOError:
|
|
return "Error reading from file";
|
|
case ISettingsProvider::Error::Internal:
|
|
return "Internal error";
|
|
case ISettingsProvider::Error::InvalidPi:
|
|
return "Error during document declaration/processing instruction parsing";
|
|
case ISettingsProvider::Error::InvalidTag:
|
|
return "Parser could not determine tag type";
|
|
case ISettingsProvider::Error::InvalidCdata:
|
|
return "Error during CDATA section parsing";
|
|
case ISettingsProvider::Error::FileNotFound:
|
|
return "File was not found";
|
|
case ISettingsProvider::Error::InvalidPcdata:
|
|
return "Error during PCDATA section parsing";
|
|
case ISettingsProvider::Error::InvalidComment:
|
|
return "Error during comment parsing";
|
|
case ISettingsProvider::Error::InvalidDocType:
|
|
return "Error during document type declaration parsing";
|
|
case ISettingsProvider::Error::InvalidSettings:
|
|
return "Settings sections is invalid or absent";
|
|
case ISettingsProvider::Error::InvalidAttribute:
|
|
return "Error during element attribute parsing";
|
|
case ISettingsProvider::Error::InvalidEndElement:
|
|
return "Error during end element tag parsing";
|
|
case ISettingsProvider::Error::AppendInvalidRoot:
|
|
return "Root type is not node_element or node_document";
|
|
case ISettingsProvider::Error::NoDocumentElement:
|
|
return "Document without element nodes";
|
|
case ISettingsProvider::Error::EndElementMismatch:
|
|
return "Mismatch of start-end tags";
|
|
case ISettingsProvider::Error::InvalidStartElement:
|
|
return "Error during start element tag parsing";
|
|
default: return "Unknown error";
|
|
}
|
|
}
|
|
};
|
|
/** @} */
|
|
}
|