ParamReader Class Reference

#include <ParamReader.h>

Public Member Functions
	ParamReader (const string &xmlFile, const string &xsdFile)
	ParamReader (const std::string &xmlFile)
	ParamReader (const ParamReader &other)
	ParamReader (ParamReader &&other)=default
bool	validateAgainst (const std::string &xsdFile) const
bool	validateAgainstInternalSchema () const
virtual	~ParamReader ()
Parameter	getParameter (const string &paramName) const
vector< Parameter >	getParameters (const string &groupName) const
t_params_map	getParameters () const
bool	existParameter (const string &paramName) const
void	setParameter (const string &paramName, string value)
void	print () const
Parameter &	getParameterRef (const string &path)
const Parameter &	getParameterRef (const string &path) const

Detailed Description

This class parses the XML configuration files provided by the openSF HMI formatted with the following elements:

• Element <group_name>. This element can create nested groups to enclose parameters and provide scope information. Optional element.
• Element parameter. This element can define the following attributes:
  • Name. This is the parameter identifier. Names cannot contain spaces;
  • Description. Short definition or meaning for the parameter;
  • Type. Possible values for this attribute are: INTEGER, DOUBLE, BOOLEAN, STRING, FILE or FOLDER. These are system-independent type of values, only intended for GUI formatting validations.
  • Value. This is the numerical, string or file location value of the parameter;
  • Units. Physical units of measurements if applicable. This attribute is optional;
  • Dims. Size of the dimensions. For example 1, 3 is a vector of three elements and 3, 3 is a square matrix of 3x3 elements. The first number refers to columns and the second one to rows when describing a matrix. This attribute is also optional: for scalar variables, dims can be avoided. For variables of vector/matrix types, the value attribute must contain a comma-separated (or blank-separated) list of values by rows, following this example: A 3 columns by 2 rows matrix (dims = 3,2) 1 2 3 4 5 6 Will be represented as: 1,2,3,4,5,6. String vectors must enclose each element in single quotes. For example 'a string' 'second string' 'third and last string'.

Constructor & Destructor Documentation

ParamReader() [1/3]

ParamReader::ParamReader	(	const string &	xmlFile,
		const string &	xsdFile
	)

Default class constructor. Creates an instance of the ParamReader class, parses a given configuration XML file and stores every valid parameter.

Validating agains an XSD schema is optional.

Parameters

xmlFile	- Configuration XML file
xsdFile	- Configuration XSD schema

Exceptions

exception

if error while parsing

Deprecated:

Broken overload. Instead of calling it, use the single argument version and then call the validateAgainst functions.

ParamReader() [2/3]

ParamReader::ParamReader

(

const std::string &

xmlFile

)

Reads OSFI-formatted parameters from the given file.

Parameters

xmlFile

Configuration XML file

Exceptions

std::exception

If an error arises during parsing.

ParamReader() [3/3]

ParamReader::ParamReader

(

const ParamReader &

other

)

Copy constructor, duplicates the map and document objects

~ParamReader()

virtual ParamReader::~ParamReader ( )

virtual

Class destructor.

Member Function Documentation

existParameter()

bool ParamReader::existParameter

(

const string &

paramName

)

const

Checks the existence of a parameter within a configuration file.

Parameters

paramName

Parameter name (full path and name)

Returns

boolean True if the parameter exists False otherwise.

getParameter()

Parameter ParamReader::getParameter

(

const string &

paramName

)

const

Gets a parameter object corresponding with the first occurrence of a parameter name into a configuration file.

Parameters

paramName

Parameter name (full path and name)

Returns

Parameter instance.

getParameterRef()

Parameter& ParamReader::getParameterRef

(

const string &

path

)

Returns a reference to a parameter in the set of read data. This method differs from getParameter() in that it does not copy the data, so the lifetime of the referee is limited to that of this instance. The returned reference is never otherwise invalidated.

Exceptions

std::invalid_argument

If the path does not correspond to a parameter.

getParameters() [1/2]

t_params_map ParamReader::getParameters

(

)

const

Gets a map containing all stored parameters.

getParameters() [2/2]

vector<Parameter> ParamReader::getParameters

(

const string &

groupName

)

const

Gets the list of parameters under a certain group.

Parameters

groupName

- full name of the group.

print()

void ParamReader::print

(

)

const

Prints a textual representation of the list of Parameters on screen.

setParameter()

void ParamReader::setParameter	(	const string &	paramName,
		string	value
	)

Changes the stored value of a certain parameter. Shows an error if cannot find parameter.

Parameters

paramName	- full name of the parameter
value	- new value

Exceptions

exception

if value is invalid

validateAgainst()

bool ParamReader::validateAgainst

(

const std::string &

xsdFile

)

const

Validate the XML document read against the given schema.

Exceptions

invalid_argument

If the schema cannot be read.

Returns

true if the document passes validation, false otherwise.

validateAgainstInternalSchema()

bool ParamReader::validateAgainstInternalSchema

(

)

const

Validate the XML document read against the schema referenced in the document itself.

Returns

true if the document passes validation, false otherwise.

---

The documentation for this class was generated from the following file:

• include/cpp/ConFM/ParamReader.h