Register holding all the allowed keywords. More...

#include <ActionRegister.h>

Public Member Functions
void	add (std::string key, creator_pointer cp, keywords_pointer kp)
	Register a new class. More...

bool	check (std::string action)
	Verify if a directive is present in the register. More...

Action *	create (const ActionOptions &ao)
	Create an Action of the type indicated in the options. More...

bool	printManual (const std::string &action, const bool &vimout)
	Print out the keywords for an action in html/vim ready for input into the manual. More...

bool	printTemplate (const std::string &action, bool include_optional)
	Print out a template command for an action. More...

void	remove (creator_pointer)

	~ActionRegister ()

Private Types
typedef Action (	creator_pointer) (const ActionOptions &)
	Pointer to a function which, given the options, create an Action. More...

typedef void(*	keywords_pointer) (Keywords &)
	Pointer to a function which, returns the keywords allowed. More...

typedef std::map< std::string, creator_pointer >::iterator	mIterator
	Iterator over the map. More...

typedef std::map< std::string, creator_pointer >::const_iterator	const_mIterator
	Iterator over the map. More...

typedef std::map< std::string, Keywords >::iterator	mIteratork
	Iterator over the map. More...

typedef std::map< std::string, Keywords >::const_iterator	const_mIteratork
	Iterator over the map. More...

Private Attributes
std::map< std::string, creator_pointer >	m
	Map action to a function which creates the related object. More...

std::map< std::string, keywords_pointer >	mk
	Map action to a function which documents the related object. More...

std::set< std::string >	disabled
	Set of disabled actions (which were registered more than once) More...

Friends
std::ostream &	operator<< (std::ostream &, const ActionRegister &)
	Write on a stream the list of registered directives. More...

Related Functions
(Note that these are not member functions.)
ActionRegister &	actionRegister ()
	Function returning a reference to the ActionRegister. More...

#define	PLUMED_REGISTER_ACTION(classname, directive)
	Shortcut for Action registration. More...

Detailed Description

Register holding all the allowed keywords.

This is a register which holds a map between strings (directives) and function pointers. The function pointers are pointing to functions which create an object of the corresponding class given the corresponding options (ActionOptions). There should be only one of there objects allocated. Actions should be registered here at the beginning of execution If the same directive is used for different classes, it is automatically disabled to avoid random results.

Member Typedef Documentation

◆ const_mIterator

typedef std::map<std::string,creator_pointer>::const_iterator PLMD::ActionRegister::const_mIterator

private

Iterator over the map.

◆ const_mIteratork

typedef std::map<std::string,Keywords>::const_iterator PLMD::ActionRegister::const_mIteratork

private

Iterator over the map.

◆ creator_pointer

typedef Action*(* PLMD::ActionRegister::creator_pointer) (const ActionOptions &)

private

Pointer to a function which, given the options, create an Action.

◆ keywords_pointer

typedef void(* PLMD::ActionRegister::keywords_pointer) (Keywords &)

private

Pointer to a function which, returns the keywords allowed.

◆ mIterator

typedef std::map<std::string,creator_pointer>::iterator PLMD::ActionRegister::mIterator

private

Iterator over the map.

◆ mIteratork

typedef std::map<std::string,Keywords>::iterator PLMD::ActionRegister::mIteratork

private

Iterator over the map.

Constructor & Destructor Documentation

◆ ~ActionRegister()

PLMD::ActionRegister::~ActionRegister ( )

Member Function Documentation

◆ add()

void PLMD::ActionRegister::add	(	std::string	key,
		creator_pointer	cp,
		keywords_pointer	kp
	)

Register a new class.

Parameters

key	The name of the directive to be used in the input file
cp	A pointer to a function which creates an object of that class
kp	A pointer to a function which returns the allowed keywords

◆ check()

bool PLMD::ActionRegister::check ( std::string action )

Verify if a directive is present in the register.

◆ create()

Action * PLMD::ActionRegister::create ( const ActionOptions & ao )

Create an Action of the type indicated in the options.

Parameters

ao	object containing information for initialization, such as the full input line, a pointer to PlumedMain, etc

◆ printManual()

bool PLMD::ActionRegister::printManual	(	const std::string &	action,
		const bool &	vimout
	)

Print out the keywords for an action in html/vim ready for input into the manual.

◆ printTemplate()

bool PLMD::ActionRegister::printTemplate	(	const std::string &	action,
		bool	include_optional
	)

Print out a template command for an action.

◆ remove()

void PLMD::ActionRegister::remove ( creator_pointer f )

Friends And Related Function Documentation

◆ actionRegister()

ActionRegister & actionRegister ( )

To avoid problems with order of initialization, this function contains a static ActionRegister which is built the first time the function is called. In this manner, it is always initialized before it's used

◆ operator<<

std::ostream& operator<<	(	std::ostream &	,
		const ActionRegister &
	)

friend

Write on a stream the list of registered directives.

◆ PLUMED_REGISTER_ACTION

#define PLUMED_REGISTER_ACTION	(	classname,
		directive
	)

static class  PLUMED_UNIQUENAME(classname##RegisterMe){ \
    static PLMD::Action* create(const PLMD::ActionOptions&ao){return new classname(ao);} \
  public: \
    PLUMED_UNIQUENAME(classname##RegisterMe)(){PLMD::actionRegister().add(directive,create,classname::registerKeywords);} \
    ~PLUMED_UNIQUENAME(classname##RegisterMe)(){PLMD::actionRegister().remove(create);} \
  } PLUMED_UNIQUENAME(classname##RegisterMe);

Shortcut for Action registration.

For easier registration, this file also provides a macro PLUMED_REGISTER_ACTION.

Parameters

classname	the name of the class to be registered
directive	a string containing the corresponding directive This macro should be used in the .cpp file of the corresponding class

Member Data Documentation

◆ disabled

std::set<std::string> PLMD::ActionRegister::disabled

private

Set of disabled actions (which were registered more than once)

◆ m

std::map<std::string,creator_pointer> PLMD::ActionRegister::m

private

Map action to a function which creates the related object.

◆ mk

std::map<std::string,keywords_pointer> PLMD::ActionRegister::mk

private

Map action to a function which documents the related object.

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

core/ActionRegister.h
core/ActionRegister.cpp

Public Member Functions

Private Types

Private Attributes

Friends

Related Functions

Detailed Description

Member Typedef Documentation

◆ const_mIterator

◆ const_mIteratork

◆ creator_pointer

◆ keywords_pointer

◆ mIterator

◆ mIteratork

Constructor & Destructor Documentation

◆ ~ActionRegister()

Member Function Documentation

◆ add()

◆ check()

◆ create()

◆ printManual()

◆ printTemplate()

◆ remove()

Friends And Related Function Documentation

◆ actionRegister()

◆ operator<<

◆ PLUMED_REGISTER_ACTION

Member Data Documentation

◆ disabled

◆ m

◆ mk