RunnableInterface Class Reference
[Activity (thread) classes.]

#include </home/sspr/src/www/orocos-1.0/export/build/orocos-rtt-1.2.2/build/rtt/RunnableInterface.hpp>

Inheritance diagram for RunnableInterface:

List of all members.

---

Detailed Description

This class adds Activity specific semantics to OS::RunnableInterface and sits in the RTT namespace.

Applications should always use this class instead of the OS version.

The getActivity() method is guaranteed to return a valid task pointer during initialize(), step() or loop() and finalize(). This allows the RunnableInterface to query the task's period(icity) and ThreadInterface. Consequently, initialize() knows whether step() or loop() will be called ( depending on ActivityInterface::isPeriodic() ).

See also:

ActivityInterface

Public Member Functions
	~RunnableInterface ()
	Checks if this is still in a task and if so, issues a critical warning.
ActivityInterface *	getActivity () const
	Query for the task this interface is run in.
virtual void	setActivity (ActivityInterface *task)
	Set the task this interface is run in.
virtual bool	initialize ()=0
	The method that will be called before the first periodical execution of step() ( or non periodical execution of loop() ), when the thread is started.
virtual void	step ()=0
	The method that will be periodically executed when this class is run in a periodic thread.
virtual void	loop ()
	The method that will be executed once when this class is run in a non periodic thread.
virtual bool	breakLoop ()
	This method is called by the framework to break out of the loop() method.
virtual void	finalize ()=0
	The method that will be called after the last periodical execution of step() ( or non periodical execution of loop() ), when the RunnableInterface is stopped.
ThreadInterface *	getThread () const
	Get the thread this object is run in.
virtual void	setThread (ThreadInterface *t)
	Set the thread this object will be run in.

---

Member Function Documentation

ActivityInterface * getActivity

(

)

const [inline]

Query for the task this interface is run in.

Zero denotes that no task is present to run it, and hence no detailed information is available.

Returns:

The Activity which runs this RunnableInterface.

virtual void setActivity

(

ActivityInterface *

task

)

[virtual]

Set the task this interface is run in.

A Zero means no task is running it.

Parameters:

task

The ActivityInterface running this interface.

Reimplemented in ExecutionEngine.

virtual void loop

(

)

[virtual, inherited]

The method that will be executed once when this class is run in a non periodic thread.

The default implementation calls step() once.

virtual bool breakLoop

(

)

[virtual, inherited]

This method is called by the framework to break out of the loop() method.

Reimplement this method to signal loop() to return and return true on success. When this method is not reimplemented by you, it will always return false, denoting that the loop can not be broken. If breakLoop() returns true, the caller will wait until loop() returns.

Returns:

true if the loop could be notified to return.

Reimplemented in EventProcessor, and ExecutionEngine.

ThreadInterface* getThread

(

)

const [inherited]

Get the thread this object is run in.

Returns:

a pointer to the thread or 0 if not run by a thread.

---

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

• rtt/RunnableInterface.hpp

---