document c++ callbacks!

[software/libev.git] / ev++.h

diff --git a/ev++.h b/ev++.h
index 500d596cd3d4d0bc408f97ad9b8efd66cd266bdc..fea0ac170ee85850d318d50d643a8ee5acbf14f9 100644 (file)
--- a/ev++.h
+++ b/ev++.h
@@ -1,50 +1,90 @@
 #ifndef EVPP_H__
 #define EVPP_H__
 
 #ifndef EVPP_H__
 #define EVPP_H__
 

-/* work in progress, don't use unless you know what you are doing */
+#include "ev.h"

 
 namespace ev {
 
 
 namespace ev {
 

-  template<class watcher>
-  class callback
+  template<class ev_watcher, class watcher>
+  struct base : ev_watcher

   {
   {

-    struct object { };
-
-    void *obj;
-    void (object::*meth)(watcher &, int);
-
-    /* a proxy is a kind of recipe on how to call a specific class method */
-    struct proxy_base {
-      virtual void call (void *obj, void (object::*meth)(watcher &, int), watcher &w, int) const = 0;
-    };
-    template<class O1, class O2>
-    struct proxy : proxy_base {
-      virtual void call (void *obj, void (object::*meth)(watcher &, int), watcher &w, int e) const
+    #if EV_MULTIPLICITY
+      EV_P;
+
+      void set (EV_P)

       {
       {

-        ((reinterpret_cast<O1 *>(obj)) ->* (reinterpret_cast<void (O2::*)(watcher &, int)>(meth)))
-          (w, e);
+        this->EV_A = EV_A;

       }
       }

-    };
+    #endif

 
 

-    proxy_base *prxy;
+    base ()
+    {
+      ev_init (this, 0);
+    }

 
 

-  public:
-    template<class O1, class O2>
-    explicit callback (O1 *object, void (O2::*method)(watcher &, int))
+    void set_ (void *object, void (*cb)(EV_P_ ev_watcher *w, int revents))

     {
     {

-      static proxy<O1,O2> p;
-      obj  = reinterpret_cast<void *>(object);
-      meth = reinterpret_cast<void (object::*)(watcher &, int)>(method);
-      prxy = &p;
+      this->data = object;
+      ev_set_cb (static_cast<ev_watcher *>(this), cb);

     }
 
     }
 

-    void call (watcher *w, int e) const
+    template<class K, void (K::*method)(watcher &w, int)>
+    void set (K *object)

     {
     {

-      return prxy->call (obj, meth, *w, e);
+      set_ (object, method_thunk<K, method>);
+    }
+
+    template<class K, void (K::*method)(watcher &w, int)>
+    static void method_thunk (EV_P_ ev_watcher *w, int revents)
+    {
+      watcher *self = static_cast<watcher *>(w);
+      K *obj = static_cast<K *>(self->data);
+      (obj->*method) (*self, revents);
+    }
+
+    template<class K, void (K::*method)(watcher &w, int) const>
+    void set (const K *object)
+    {
+      set_ (object, const_method_thunk<K, method>);
+    }
+
+    template<class K, void (K::*method)(watcher &w, int) const>
+    static void const_method_thunk (EV_P_ ev_watcher *w, int revents)
+    {
+      watcher *self = static_cast<watcher *>(w);
+      K *obj = static_cast<K *>(self->data);
+      (obj->*method) (*self, revents);
+    }
+
+    template<void (*function)(watcher &w, int), void *data = 0>
+    void set ()
+    {
+      set_ (data, function_thunk<function>);
+    }
+
+    template<void (*function)(watcher &w, int)>
+    static void function_thunk (EV_P_ ev_watcher *w, int revents)
+    {
+      watcher *self = static_cast<watcher *>(w);
+      function (*self, revents);

     }
     }

-  };

 
 

-  #include "ev.h"
+    void operator ()(int events = EV_UNDEF)
+    {
+      return ev_cb (static_cast<ev_watcher *>(this))
+        (static_cast<ev_watcher *>(this), events);
+    }
+
+    bool is_active () const
+    {
+      return ev_is_active (static_cast<const ev_watcher *>(this));
+    }
+
+    bool is_pending () const
+    {
+      return ev_is_pending (static_cast<const ev_watcher *>(this));
+    }
+  };

 
   enum {
     UNDEF    = EV_UNDEF,
 
   enum {
     UNDEF    = EV_UNDEF,


@@ -54,10 +94,13 @@ namespace ev {
     TIMEOUT  = EV_TIMEOUT,
     PERIODIC = EV_PERIODIC,
     SIGNAL   = EV_SIGNAL,
     TIMEOUT  = EV_TIMEOUT,
     PERIODIC = EV_PERIODIC,
     SIGNAL   = EV_SIGNAL,

+    CHILD    = EV_CHILD,
+    STAT     = EV_STAT,

     IDLE     = EV_IDLE,
     CHECK    = EV_CHECK,
     PREPARE  = EV_PREPARE,
     IDLE     = EV_IDLE,
     CHECK    = EV_CHECK,
     PREPARE  = EV_PREPARE,

-    CHILD    = EV_CHILD,
+    FORK     = EV_FORK,
+    EMBED    = EV_EMBED,

     ERROR    = EV_ERROR,
   };
 
     ERROR    = EV_ERROR,
   };
 


@@ -69,51 +112,24 @@ namespace ev {
   }
 
   #if EV_MULTIPLICITY
   }
 
   #if EV_MULTIPLICITY

-
-    #define EV_CONSTRUCT(cppstem)                                                      \
-      EV_P;                                                                             \
-                                                                                        \
-      void set (EV_P)                                                                   \
+    #define EV_CONSTRUCT                                                                \
+      (EV_P = EV_DEFAULT)                                                               \

       {                                                                                 \
       {                                                                                 \

-        this->EV_A = EV_A;                                                              \
-      }                                                                                 \
-                                                                                        \
-      template<class O1, class O2>                                                      \
-      explicit cppstem (O1 *object, void (O2::*method)(cppstem &, int), EV_P = ev_default_loop (0)) \
-      : callback<cppstem> (object, method), EV_A (EV_A)
-
+        set (EV_A);                                                                     \
+      }

   #else
   #else

-
-    #define EV_CONSTRUCT(cppstem)                                                      \
-      template<class O1, class O2>                                                     \
-      explicit cppstem (O1 *object, void (O2::*method)(cppstem &, int))                 \
-      : callback<cppstem> (object, method)
-
+    #define EV_CONSTRUCT                                                                \
+      ()                                                                                \
+      {                                                                                 \
+      }

   #endif
 
   /* using a template here would require quite a bit more lines,
    * so a macro solution was chosen */
   #endif
 
   /* using a template here would require quite a bit more lines,
    * so a macro solution was chosen */

-  #define EV_DECLARE_WATCHER(cppstem,cstem)                                            \
-                                                                                        \
-  extern "C" void cb_ ## cppstem (struct ev_ ## cstem *w, int revents);                 \
+  #define EV_BEGIN_WATCHER(cppstem,cstem)                                              \

                                                                                         \
                                                                                         \

-  struct cppstem : ev_ ## cstem, callback<cppstem>                                      \
+  struct cppstem : base<ev_ ## cstem, cppstem>                                          \

   {                                                                                     \
   {                                                                                     \

-    EV_CONSTRUCT (cppstem)                                                              \
-    {                                                                                   \
-      ev_init (static_cast<ev_ ## cstem *>(this), cb_ ## cppstem);                      \
-    }                                                                                   \
-                                                                                        \
-    bool is_active () const                                                             \
-    {                                                                                   \
-      return ev_is_active (static_cast<const ev_ ## cstem *>(this));                    \
-    }                                                                                   \
-                                                                                        \
-    bool is_pending () const                                                            \
-    {                                                                                   \
-      return ev_is_pending (static_cast<const ev_ ## cstem *>(this));                   \
-    }                                                                                   \
-                                                                                        \

     void start ()                                                                       \
     {                                                                                   \
       ev_ ## cstem ## _start (EV_A_ static_cast<ev_ ## cstem *>(this));                 \
     void start ()                                                                       \
     {                                                                                   \
       ev_ ## cstem ## _start (EV_A_ static_cast<ev_ ## cstem *>(this));                 \


@@ -124,26 +140,28 @@ namespace ev {
       ev_ ## cstem ## _stop (EV_A_ static_cast<ev_ ## cstem *>(this));                  \
     }                                                                                   \
                                                                                         \
       ev_ ## cstem ## _stop (EV_A_ static_cast<ev_ ## cstem *>(this));                  \
     }                                                                                   \
                                                                                         \

-    void operator ()(int events = EV_UNDEF)                                             \
-    {                                                                                   \
-      return call (this, events);                                                       \
-    }                                                                                   \
+    cppstem EV_CONSTRUCT                                                                \

                                                                                         \
     ~cppstem ()                                                                         \
     {                                                                                   \
       stop ();                                                                          \
     }                                                                                   \
                                                                                         \
                                                                                         \
     ~cppstem ()                                                                         \
     {                                                                                   \
       stop ();                                                                          \
     }                                                                                   \
                                                                                         \

+    using base<ev_ ## cstem, cppstem>::set;                                             \
+                                                                                        \

   private:                                                                              \
                                                                                         \
     cppstem (const cppstem &o)                                                         \
   private:                                                                              \
                                                                                         \
     cppstem (const cppstem &o)                                                         \

-    : callback<cppstem> (this, (void (cppstem::*)(cppstem &, int))0)                    \

     { /* disabled */ }                                                                 \
     { /* disabled */ }                                                                 \

+                                                                                        \

     void operator =(const cppstem &o) { /* disabled */ }                                \
                                                                                         \
   public:
 
     void operator =(const cppstem &o) { /* disabled */ }                                \
                                                                                         \
   public:
 

-  EV_DECLARE_WATCHER (io, io)
+  #define EV_END_WATCHER(cppstem,cstem)                                                        \
+  };
+
+  EV_BEGIN_WATCHER (io, io)

     void set (int fd, int events)
     {
       int active = is_active ();
     void set (int fd, int events)
     {
       int active = is_active ();


@@ -165,9 +183,9 @@ namespace ev {
       set (fd, events);
       start ();
     }
       set (fd, events);
       start ();
     }

-  };
+  EV_END_WATCHER (io, io)

 
 

-  EV_DECLARE_WATCHER (timer, timer)
+  EV_BEGIN_WATCHER (timer, timer)

     void set (ev_tstamp after, ev_tstamp repeat = 0.)
     {
       int active = is_active ();
     void set (ev_tstamp after, ev_tstamp repeat = 0.)
     {
       int active = is_active ();


@@ -186,10 +204,10 @@ namespace ev {
     {
       ev_timer_again (EV_A_ static_cast<ev_timer *>(this));
     }
     {
       ev_timer_again (EV_A_ static_cast<ev_timer *>(this));
     }

-  };
+  EV_END_WATCHER (timer, timer)

 
 

-  #if EV_PERIODICS
-  EV_DECLARE_WATCHER (periodic, periodic)
+  #if EV_PERIODIC_ENABLE
+  EV_BEGIN_WATCHER (periodic, periodic)

     void set (ev_tstamp at, ev_tstamp interval = 0.)
     {
       int active = is_active ();
     void set (ev_tstamp at, ev_tstamp interval = 0.)
     {
       int active = is_active ();


@@ -208,19 +226,10 @@ namespace ev {
     {
       ev_periodic_again (EV_A_ static_cast<ev_periodic *>(this));
     }
     {
       ev_periodic_again (EV_A_ static_cast<ev_periodic *>(this));
     }

-  };
+  EV_END_WATCHER (periodic, periodic)

   #endif
 
   #endif
 

-  EV_DECLARE_WATCHER (idle, idle)
-  };
-
-  EV_DECLARE_WATCHER (prepare, prepare)
-  };
-
-  EV_DECLARE_WATCHER (check, check)
-  };
-
-  EV_DECLARE_WATCHER (sig, signal)
+  EV_BEGIN_WATCHER (sig, signal)

     void set (int signum)
     {
       int active = is_active ();
     void set (int signum)
     {
       int active = is_active ();


@@ -234,9 +243,9 @@ namespace ev {
       set (signum);
       start ();
     }
       set (signum);
       start ();
     }

-  };
+  EV_END_WATCHER (sig, signal)

 
 

-  EV_DECLARE_WATCHER (child, child)
+  EV_BEGIN_WATCHER (child, child)

     void set (int pid)
     {
       int active = is_active ();
     void set (int pid)
     {
       int active = is_active ();


@@ -250,10 +259,69 @@ namespace ev {
       set (pid);
       start ();
     }
       set (pid);
       start ();
     }

-  };
+  EV_END_WATCHER (child, child)
+
+  #if EV_STAT_ENABLE
+  EV_BEGIN_WATCHER (stat, stat)
+    void set (const char *path, ev_tstamp interval = 0.)
+    {
+      int active = is_active ();
+      if (active) stop ();
+      ev_stat_set (static_cast<ev_stat *>(this), path, interval);
+      if (active) start ();
+    }
+
+    void start (const char *path, ev_tstamp interval = 0.)
+    {
+      stop ();
+      set (path, interval);
+      start ();
+    }
+
+    void update ()
+    {
+      ev_stat_stat (EV_A_ static_cast<ev_stat *>(this));
+    }
+  EV_END_WATCHER (stat, stat)
+  #endif
+
+  EV_BEGIN_WATCHER (idle, idle)
+    void set () { }
+  EV_END_WATCHER (idle, idle)
+
+  EV_BEGIN_WATCHER (prepare, prepare)
+    void set () { }
+  EV_END_WATCHER (prepare, prepare)
+
+  EV_BEGIN_WATCHER (check, check)
+    void set () { }
+  EV_END_WATCHER (check, check)
+
+  #if EV_EMBED_ENABLE
+  EV_BEGIN_WATCHER (embed, embed)
+    void start (struct ev_loop *embedded_loop)
+    {
+      stop ();
+      ev_embed_set (static_cast<ev_embed *>(this), embedded_loop);
+      start ();
+    }
+
+    void sweep ()
+    {
+      ev_embed_sweep (EV_A_ static_cast<ev_embed *>(this));
+    }
+  EV_END_WATCHER (embed, embed)
+  #endif
+
+  #if EV_FORK_ENABLE
+  EV_BEGIN_WATCHER (fork, fork)
+    void set () { }
+  EV_END_WATCHER (fork, fork)
+  #endif

 
   #undef EV_CONSTRUCT
 
   #undef EV_CONSTRUCT

-  #undef EV_DECLARE_WATCHER
+  #undef EV_BEGIN_WATCHER
+  #undef EV_END_WATCHER

 }
 
 #endif
 }
 
 #endif