RobotRaconteur::SyncGenerator< Return, Param > Class Template Reference

Helper class for synchronous service generators. More...

#include <Generator.h>

Inheritance diagram for RobotRaconteur::SyncGenerator< Return, Param >:

Public Member Functions
RR_OVIRTUAL Return	Next (const Param &v) RR_OVERRIDE=0
	Advance the generator.
RR_OVIRTUAL void	AsyncNext (const Param &v, boost::function< void(const Return &, const boost::shared_ptr< RobotRaconteurException > &err)> handler, int32_t timeout=RR_TIMEOUT_INFINITE) RR_OVERRIDE
	Asynchronously advance the generator.
RR_OVIRTUAL void	Abort () RR_OVERRIDE=0
	Abort the generator.
RR_OVIRTUAL void	AsyncAbort (boost::function< void(const boost::shared_ptr< RobotRaconteurException > &)> handler, int32_t timeout=RR_TIMEOUT_INFINITE) RR_OVERRIDE
	Asynchronously abort the generator.
RR_OVIRTUAL void	Close () RR_OVERRIDE=0
	Close the generator.
RR_OVIRTUAL void	AsyncClose (boost::function< void(const boost::shared_ptr< RobotRaconteurException > &)> handler, int32_t timeout=RR_TIMEOUT_INFINITE) RR_OVERRIDE
	Asynchronously closes the generator.
virtual bool	TryNext (const Param &v, Return &ret)
	Try to advance the generator. Return false if no more values are available.
virtual void	AsyncAbort (boost::function< void(const boost::shared_ptr< RobotRaconteurException > &err)> handler, int32_t timeout=RR_TIMEOUT_INFINITE)=0
	Asynchronously abort the generator.
virtual void	AsyncClose (boost::function< void(const boost::shared_ptr< RobotRaconteurException > &err)> handler, int32_t timeout=RR_TIMEOUT_INFINITE)=0
	Asynchronously closes the generator.

Detailed Description

template<typename Return, typename Param>
class RobotRaconteur::SyncGenerator< Return, Param >

Helper class for synchronous service generators.

By default, services will call AsyncNext(), AsyncClose(), and AsyncAbort(). This class will redirect these calls to synchronous Next(), Close, and Abort(). Inherit from SyncGenerator for this behavior.

Member Function Documentation

Abort()

template<typename Return, typename Param>

RR_OVIRTUAL void RobotRaconteur::SyncGenerator< Return, Param >::Abort ( )

pure virtual

Abort the generator.

Aborts and destroys the generator. This is assumed to be an error condition. Next() should throw OperationAbortedException if called after Abort(). Any ongoing operations should be terminated with an error condition, for example a moving robot should be immediately halted.

Implements RobotRaconteur::Generator< Return, Param >.

Implemented in RobotRaconteur::RangeGenerator< T >.

AsyncAbort() [1/2]

template<typename Return, typename Param>

virtual void RobotRaconteur::Generator< Return, Param >::AsyncAbort ( boost::function< void(const boost::shared_ptr< RobotRaconteurException > &err)> handler, int32_t timeout = RR_TIMEOUT_INFINITE )

pure virtualinherited

Asynchronously abort the generator.

Same as Abort() but returns asynchronously.

Parameters

handler	The handler to call when abort is complete
timeout	Timeout in milliseconds, or RR_TIMEOUT_INFINITE for no timeout.

AsyncAbort() [2/2]

template<typename Return, typename Param>

RR_OVIRTUAL void RobotRaconteur::SyncGenerator< Return, Param >::AsyncAbort ( boost::function< void(const boost::shared_ptr< RobotRaconteurException > &)> handler, int32_t timeout = RR_TIMEOUT_INFINITE )

inline

Asynchronously abort the generator.

Same as Abort() but returns asynchronously.

Parameters

handler	The handler to call when abort is complete
timeout	Timeout in milliseconds, or RR_TIMEOUT_INFINITE for no timeout.

AsyncClose() [1/2]

template<typename Return, typename Param>

virtual void RobotRaconteur::Generator< Return, Param >::AsyncClose ( boost::function< void(const boost::shared_ptr< RobotRaconteurException > &err)> handler, int32_t timeout = RR_TIMEOUT_INFINITE )

pure virtualinherited

Asynchronously closes the generator.

Same as Close() but returns asynchronously.

Parameters

handler	The handler to call when close is complete
timeout	Timeout in milliseconds, or RR_TIMEOUT_INFINITE for no timeout.

AsyncClose() [2/2]

template<typename Return, typename Param>

RR_OVIRTUAL void RobotRaconteur::SyncGenerator< Return, Param >::AsyncClose ( boost::function< void(const boost::shared_ptr< RobotRaconteurException > &)> handler, int32_t timeout = RR_TIMEOUT_INFINITE )

inline

Asynchronously closes the generator.

Same as Close() but returns asynchronously.

Parameters

handler	The handler to call when close is complete
timeout	Timeout in milliseconds, or RR_TIMEOUT_INFINITE for no timeout.

AsyncNext()

template<typename Return, typename Param>

RR_OVIRTUAL void RobotRaconteur::SyncGenerator< Return, Param >::AsyncNext ( const Param & v, boost::function< void(const Return &, const boost::shared_ptr< RobotRaconteurException > &err)> handler, int32_t timeout = RR_TIMEOUT_INFINITE )

inlinevirtual

Asynchronously advance the generator.

Same as Next() but returns asynchronously.

Parameters

v	Parameter to pass to generator
handler	A handler function to receive the return value or an exception
timeout	Timeout in milliseconds, or RR_TIMEOUT_INFINITE for no timeout.

Implements RobotRaconteur::Generator< Return, Param >.

Close()

template<typename Return, typename Param>

RR_OVIRTUAL void RobotRaconteur::SyncGenerator< Return, Param >::Close ( )

pure virtual

Close the generator.

Closes the generator. Closing the generator terminates iteration and destroys the generator. This operation cleanly closes the generator, and is not considered to be an error condition. Next() should throw StopIterationException if called after Close().

Implements RobotRaconteur::Generator< Return, Param >.

Implemented in RobotRaconteur::RangeGenerator< T >.

Next()

template<typename Return, typename Param>

RR_OVIRTUAL Return RobotRaconteur::SyncGenerator< Return, Param >::Next ( const Param & v )

pure virtual

Advance the generator.

Next() advances the generator to retrieve the next value. This version of Generator includes passing a parameter v to the generator.

Parameters

v	Parameter to pass to generator

Returns

Return Return value from generator

Implements RobotRaconteur::Generator< Return, Param >.

TryNext()

template<typename Return, typename Param>

virtual bool RobotRaconteur::Generator< Return, Param >::TryNext ( const Param & v, Return & ret )

inlinevirtualinherited

Try to advance the generator. Return false if no more values are available.

TryNext() is similar to Next() but returns false if no more values are available. This is useful for generators that may not have a fixed number of values.

Parameters

v	Parameter to pass to generator
ret	Return value from generator

Returns

true ret is valid

false ret is not valid. No more values are available.

---

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

• /builddir/build/BUILD/robotraconteur-1.2.8-build/RobotRaconteur-1.2.8-Source/RobotRaconteurCore/include/RobotRaconteur/Generator.h