Tulip  4.6.0
Better Visualization Through Research
tlp::ParameterDescriptionList Struct Reference

#include <WithParameter.h>

List of all members.

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
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 139 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 153 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 242 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

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 233 of file WithParameter.h.

 All Classes Files Functions Variables Enumerations Enumerator Properties