tlp::ParameterDescriptionList Struct Reference

#include <WithParameter.h>

Public Member Functions
template<typename T >
void	add (const std::string &parameterName, const std::string &help, const std::string &defaultValue, bool isMandatory=true, ParameterDirection direction=IN_PARAM)
void	buildDefaultDataSet (DataSet &ioDataSet, Graph *inG=NULL) const
const std::string &	getDefaultValue (const std::string &parameterName) const
tlp::Iterator < ParameterDescription > *	getParameters () const
bool	isMandatory (const std::string &parameterName) const
void	setDefaultValue (const std::string &parameterName, const std::string &value)
unsigned int	size () const

Detailed Description

This class describes parameters taken by a plugin.

It is used by WithParameter to store parameters. Each parameter is identified by a name, has a default value, a value, a help string, and a boolean indicating whether it is mandatory or optional.

Definition at line 133 of file WithParameter.h.

Member Function Documentation

template<typename T >

void tlp::ParameterDescriptionList::add ( const std::string &  parameterName, const std::string &  help, const std::string &  defaultValue, bool  isMandatory = true, ParameterDirection  direction = IN_PARAM  )

inline

Adds a new parameter of type T to the list.

Parameters

parameterName	The name of the parameter.
help	The help string of this parameter. Defaults to std::string().
defaultValue	The default value of this parameter. Defaults to std::string().
isMandatory	Whether this parameter is mandatory or optional. Defaults to true.
direction	The parameter's direction (see tlp::ParameterDirection for details)

Returns

void

Definition at line 147 of file WithParameter.h.

void tlp::ParameterDescriptionList::buildDefaultDataSet	(	DataSet &	ioDataSet,
		Graph *	inG = NULL
	)		const

Builds a DataSet containing the default values for each parameter. If the DataSet has a key which is equal to a parameter's name, the existing value is kept.

Parameters

ioDataSet	The input dataset on which the parameters names will be associated with their default values.
inG	A graph on which to create properties if any parameter is of a property type. Defaults to 0.

Returns

void

const std::string& tlp::ParameterDescriptionList::getDefaultValue

(

const std::string &

parameterName

)

const

retrieves the default value of a parameter.

Parameters

parameterName

The name of the parameter to retrieve the default value of.

Returns

The default value of the parameter:string

tlp::Iterator<ParameterDescription>* tlp::ParameterDescriptionList::getParameters

(

)

const

Retrieves an Iterator on the parameters.

Returns

An iterator over the parameters :Iterator<ParameterDescription>*

bool tlp::ParameterDescriptionList::isMandatory

(

const std::string &

parameterName

)

const

Retrieves whether a parameter is mandatory or optional.

Parameters

parameterName

The name of the parameter for which to check if it is mandatory or optional.

Returns

bool true if the parameter is mandatory, false if it is optional.

void tlp::ParameterDescriptionList::setDefaultValue	(	const std::string &	parameterName,
		const std::string &	value
	)

Sets the default value of a parameter.

Parameters

parameterName	The name of the parameter to set the value of.
value	The new value for this parameter.

Returns

void