SDK settings provider interface. More...

#include <ISettingsProvider.h>

Inheritance diagram for fsdk::ISettingsProvider:

Classes
struct	Desc
	Configuration parameter description. More...
struct	Entry
	Configuration parameter entry. More...
struct	Key
	Configuration parameter key. More...
struct	Value
	Configuration parameter value. More...
Public Types
enum	Error { Ok, IOError, Memory, Internal, InvalidPi, InvalidTag, InvalidCdata, FileNotFound, InvalidPcdata, InvalidDocType, InvalidSettings, InvalidComment, InvalidAttribute, InvalidEndElement, AppendInvalidRoot, NoDocumentElement, EndElementMismatch, InvalidStartElement, MemoryAllocationFailed }
	Config parsing error codes. More...
Public Member Functions
virtual const char *	getDefaultPath () const noexcept=0
	Get settings path this provider is bound to.
virtual void	setDefaultPath (const char *path) noexcept=0
	Sets default path for saving of settings provider.
virtual Result< Error >	load (const char *path) noexcept=0
	Load settings from given path.
virtual Result< Error >	loadFromString (const char *content) noexcept=0
	Load settings from given xml-formatted string.
virtual bool	save (const char *path) const noexcept=0
	Save settings values using the default path.
virtual void	clear () noexcept=0
	Clear settings.
virtual bool	isEmpty () const noexcept=0
virtual void	setDesc (const Key &key, const Desc &desc) noexcept=0
	Set parameter description.
void	setDesc (const char section, const char parameter, const Desc &desc) noexcept
	Set parameter description.
virtual void	setValue (const Key &key, Value &&value) noexcept=0
	Set parameter value.
void	setValue (const char section, const char parameter, Value &&value) noexcept
	Set parameter value.
virtual void	setEntry (const Key &key, Entry &&entry) noexcept=0
	Set parameter.
void	setEntry (const Key &key, const Desc &desc, Value &&value) noexcept
	Set parameter.
void	setEntry (const char section, const char parameter, const Desc &desc, Value &&value) noexcept
	Set parameter.
virtual const Entry &	getEntry (const Key &key) const noexcept=0
	Find parameter entry.
Desc	getDesc (const Key &key) const noexcept
	Get parameter description.
Desc	getDesc (const char section, const char parameter) const noexcept
	Get parameter description.
const Value &	getValue (const Key &key) const noexcept
	Get parameter value.
const Value &	getValue (const char section, const char parameter) const noexcept
	Get parameter value.

Detailed Description

SDK settings provider interface.

Takes care of loading and parsing of SDK configuration files.

Member Enumeration Documentation

enum fsdk::ISettingsProvider::Error

Config parsing error codes.

Enumerator:

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	(exclusive to xml_node::append_buffer) Unable to append nodes since root type is not node_element or node_document
NoDocumentElement	Parsing resulted in a document without element nodes.
EndElementMismatch	tag was not closed or there was an excessive closing tag) There was a mismatch of start-end tags (closing tag had incorrect name, some
InvalidStartElement	Parsing error occurred while parsing start element tag.
MemoryAllocationFailed	memory allocation failed for internal data

Member Function Documentation

virtual void fsdk::ISettingsProvider::clear ( ) [pure virtual]

Clear settings.

Returns:: true if succeded, false otherwise.

virtual const char* fsdk::ISettingsProvider::getDefaultPath ( ) const [pure virtual]

Get settings path this provider is bound to.

This is the same path that was given to load().

Returns:: path string.

Desc fsdk::ISettingsProvider::getDesc ( const Key & key ) const

Get parameter description.

Lookup parameter by key. Return empty description if the parameters does not exist.

Parameters:

key	parameter key.

Returns:: parameter description.

Desc fsdk::ISettingsProvider::getDesc	(	const char *	section,
		const char *	parameter
	)		const

Get parameter description.

Lookup parameter by key. Return empty description if the parameters does not exist.

Parameters:

section	parameter section.
parameter	parameter name.

Returns:: parameter description.

virtual const Entry& fsdk::ISettingsProvider::getEntry ( const Key & key ) const [pure virtual]

Find parameter entry.

Lookup parameter by key. Return empty entry if the parameters does not exist.

Parameters:

key	parameter key.

Returns:: parameter entry.

const Value& fsdk::ISettingsProvider::getValue ( const Key & key ) const

Get parameter value.

Lookup parameter by key. Return empty value if the parameters does not exist.

Parameters:

key	parameter key.

Returns:: parameter value.

const Value& fsdk::ISettingsProvider::getValue	(	const char *	section,
		const char *	parameter
	)		const

Get parameter value.

Lookup parameter by key. Return empty value if the parameters does not exist.

Parameters:

section	parameter section.
parameter	parameter name.

Returns:: parameter value.

virtual bool fsdk::ISettingsProvider::isEmpty ( ) const [pure virtual]

Check if there are loaded settings.

Returns:: true if provider is empty.

virtual Result<Error> fsdk::ISettingsProvider::load ( const char * path ) [pure virtual]

Load settings from given path.

Parameters:

path	configuration file path

Returns:: Result with error code specified by ISettingsProvider::ParseError.

See also:: Result and ISettingsProvider::ParseError.

virtual Result<Error> fsdk::ISettingsProvider::loadFromString ( const char * content ) [pure virtual]

Load settings from given xml-formatted string.

Parameters:

content content of xml-formatted file as a string, in a case of nullptr empty config will be created

Returns:: Result with error code specified by ISettingsProvider::ParseError.

See also:: Result and ISettingsProvider::ParseError.

virtual bool fsdk::ISettingsProvider::save ( const char * path ) const [pure virtual]

Save settings values using the default path.

path may be null, in this case a path from getDefaultPath() will be used.

Returns:: true if succeded, false otherwise.

virtual void fsdk::ISettingsProvider::setDefaultPath ( const char * path ) [pure virtual]

Sets default path for saving of settings provider.

Parameters:

path	default path

virtual void fsdk::ISettingsProvider::setDesc	(	const Key &	key,
		const Desc &	desc
	)		`[pure virtual]`

Set parameter description.