Main Page | Modules | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Class Members | File Members | Related Pages

WvCont Class Reference

#include <wvcont.h>

List of all members.


Detailed Description

WvCont provides "continuations", which are apparently also known as semi-coroutines.

You can wrap any WvCallback<void*,void*> in a WvCont and make it a "continuable" callback - that is, you can yield() from it and return a value. Next time someone calls your callback, it will be as if yield() has returned (and the parameter to your function is returned from yield()).


Public Member Functions

 WvCont (const WvContCallback &cb, unsigned long stacksize=64 *1024)
 Construct a WvCont using an existing WvCallback.
 WvCont (const WvCont &cb)
 Copy constructor.
 ~WvCont ()
 Destructor.
void * operator() (void *p1=0)
 call the callback, making p1 the return value of yield() or the parameter to the function, and returning Ret, the argument of yield() or the return value of the function.

Static Public Member Functions

static WvCont current ()
 Get a copy of the current WvCont.
static void * yield (void *ret=0)
 "return" from the current callback, giving value 'ret' to the person who called us.
static bool isok ()
 Tell us if the current context is "okay", that is, not trying to die.
template<typename R, typename T>
static R c_bouncer (T t, void *_cont)
 A templated function that allows you to pass a WvCont wherever a C-style function pointer of the form R func(T, void *userdata) is taken.
template<typename R>
static R c_bouncer (void *_cont)
 A templated function that allows you to pass a WvCont wherever a C-style function pointer of the form R func(void *userdata) is taken.

Friends

struct Data

Classes

struct  Data


Constructor & Destructor Documentation

WvCont::WvCont const WvContCallback &  cb,
unsigned long  stacksize = 64 *1024
 

Construct a WvCont using an existing WvCallback.

The WvCont object can be used in place of that callback, and stored in a callback of the same data type.


Member Function Documentation

void * WvCont::yield void *  ret = 0  )  [static]
 

"return" from the current callback, giving value 'ret' to the person who called us.

Next time this callback is called, it's as if yield() had returned, and the parameter to the callback is the value of yield().

bool WvCont::isok  )  [static]
 

Tell us if the current context is "okay", that is, not trying to die.

If !isok(), you shouldn't yield(), because the caller is just going to keep calling you until you die. Return as soon as you can.

template<typename R, typename T>
static R WvCont::c_bouncer t,
void *  _cont
[inline, static]
 

A templated function that allows you to pass a WvCont wherever a C-style function pointer of the form R func(T, void *userdata) is taken.

It's your job to make sure the 'userdata' provided is a pointer to the right WvCont.

Example: typedef bool MyFunc(Obj *obj, void *userdata); WvCont cont; MyFunc *func = &WvCont::c_bouncer<bool,Obj *>; bool b = func(new Obj, &cont);

template<typename R>
static R WvCont::c_bouncer void *  _cont  )  [inline, static]
 

A templated function that allows you to pass a WvCont wherever a C-style function pointer of the form R func(void *userdata) is taken.

It's your job to make sure the 'userdata' provided is a pointer to the right WvCont.

Example: typedef bool MyFunc(void *userdata); WvCont cont; MyFunc *func = &WvCont::c_bouncer<bool>; bool b = func(&cont);


The documentation for this class was generated from the following files:
Generated on Sun Jul 10 15:30:35 2005 for WvStreams by  doxygen 1.4.0