RTT::CommandIllegal Class Reference

A Command indicating that an error was encountered somewhere, most likely during the construction of another command. More...

#include <rtt/CommandIllegal.hpp>

Inheritance diagram for RTT::CommandIllegal:
RTT::ActionInterface

List of all members.

Public Types

typedef boost::shared_ptr
< ActionInterface
shared_ptr
 Use this type for shared pointer storage of an ActionInterface object.

Public Member Functions

 CommandIllegal (const std::string &cmd)
 Construct a new CommandIllegal with the illegal std::stringcommand as argument.
 CommandIllegal (const std::string &cmd, const std::string &descr)
 Construct a new CommandIllegal with the illegal std::stringcommand as argument and a description.
void readArguments ()
 This is invoked some time before execute() at a time when the action may read its function arguments.
virtual bool execute ()
 Execute the functionality of this action.
virtual void warn ()
 Preferably, this function is executed right after a CommandIllegal has been created.
virtual CommandInterfaceclone () const
 The Clone Software Pattern.
virtual void reset ()
 Reset this action.
virtual bool valid () const
 Inspect if this action was executed and valid.
virtual ActionInterfacecopy (std::map< const DataSourceBase *, DataSourceBase * > &alreadyCloned) const
 When copying an Orocos program, we want identical DataSource's to be mapped to identical DataSources, in order for the program to work correctly.

Detailed Description

A Command indicating that an error was encountered somewhere, most likely during the construction of another command.

Deprecated:
Remove this low-level class since it's nowhere used.

Definition at line 55 of file CommandIllegal.hpp.


Constructor & Destructor Documentation

RTT::CommandIllegal::CommandIllegal ( const std::string &  cmd  ) 

Construct a new CommandIllegal with the illegal std::stringcommand as argument.

Parameters:
cmd command that failed
RTT::CommandIllegal::CommandIllegal ( const std::string &  cmd,
const std::string &  descr 
)

Construct a new CommandIllegal with the illegal std::stringcommand as argument and a description.

Parameters:
cmd command that failed
descr description

Member Function Documentation

virtual ActionInterface* RTT::ActionInterface::copy ( std::map< const DataSourceBase *, DataSourceBase * > &  alreadyCloned  )  const [virtual, inherited]

When copying an Orocos program, we want identical DataSource's to be mapped to identical DataSources, in order for the program to work correctly.

This is different from the clone function, where we simply want a new Action that can replace the old one directly.

This function takes a map that maps the old DataSource's onto their new replacements. This way, it is possible to check before cloning a DataSource, whether it has already been copied, and if so, reuse the existing copy.

To keep old source working, the standard implementation of this function simply calls the clone function. If your ActionInterface uses a DataSource, it is important that you reimplement this function correctly though.

Reimplemented in RTT::AsynchCommandDecorator, RTT::CommandComposite, RTT::CommandDataSource, RTT::CommandDataSourceBool, RTT::CommandDispatch, RTT::CommandExecFunction, RTT::Corba::CommandProxy, RTT::detail::DataSourceArgsCommand< CommandT, CommandF >, RTT::detail::DataSourceArgsEvent< SignatureT, FunctorT >, RTT::DispatchAction, RTT::DispatchInterface, RTT::TryCommand, and RTT::EvalCommand.

virtual bool RTT::CommandIllegal::execute (  )  [virtual]

Execute the functionality of this action.

Returns:
true if the action was accepted, false otherwise

Implements RTT::ActionInterface.

virtual void RTT::ActionInterface::reset (  )  [virtual, inherited]
virtual bool RTT::ActionInterface::valid (  )  const [virtual, inherited]

Inspect if this action was executed and valid.

This method may not be called before execute(). The default implementation returns always true, i.e. after execute(), it was executed. Override this method if it has more complex state semantics.

Reimplemented in RTT::CommandComposite, RTT::CommandDispatch, RTT::CommandExecFunction, RTT::Corba::CommandProxy, RTT::detail::DataSourceArgsCommand< CommandT, CommandF >, RTT::DispatchAction, RTT::DispatchInterface, and RTT::TryCommand.

virtual void RTT::CommandIllegal::warn (  )  [virtual]

Preferably, this function is executed right after a CommandIllegal has been created.

This function can give feedback about a failed command before the CommandIllegal is actually executed


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

Generated on Tue Jul 13 11:03:24 2010 for Orocos Real-Time Toolkit by  doxygen 1.6.1