Tulip  4.3.0
Better Visualization Through Research
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Properties Groups Pages
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
parameterNameThe name of the parameter.
helpThe help string of this parameter. Defaults to std::string().
defaultValueThe default value of this parameter. Defaults to std::string().
isMandatoryWhether this parameter is mandatory or optional. Defaults to true.
directionThe 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
ioDataSetThe input dataset on which the parameters names will be associated with their default values.
inGA 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
parameterNameThe 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
parameterNameThe 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
parameterNameThe name of the parameter to set the value of.
valueThe new value for this parameter.
Returns
void