Tulip  4.10.0
Better Visualization Through Research
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, const std::string &valuesDescription=std::string())
 
void buildDefaultDataSet (DataSet &ioDataSet, Graph *inG=NULL) const
 
bool empty () 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)
 
void setDirection (const std::string &parameterName, ParameterDirection direction)
 
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 149 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,
const std::string &  valuesDescription = std::string() 
)
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 163 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
bool tlp::ParameterDescriptionList::empty ( ) const
inline

Test if the list is empty.

Returns
bool true if the parameter description list is empty, false otherwise.

Definition at line 253 of file WithParameter.h.

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
void tlp::ParameterDescriptionList::setDirection ( const std::string &  parameterName,
ParameterDirection  direction 
)

Sets the direction of a parameter.

Parameters
parameterNameThe name of the parameter to set the value of.
dirThe new direction for this parameter.
Returns
void
unsigned int tlp::ParameterDescriptionList::size ( ) const
inline

Returns the number of parameters.

Returns
The number of parameters

Definition at line 244 of file WithParameter.h.