2 * libev simple C++ wrapper classes
4 * Copyright (c) 2007,2008,2010 Marc Alexander Lehmann <libev@schmorp.de>
7 * Redistribution and use in source and binary forms, with or without modifica-
8 * tion, are permitted provided that the following conditions are met:
10 * 1. Redistributions of source code must retain the above copyright notice,
11 * this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
18 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
19 * CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
20 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
21 * CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
22 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
23 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
24 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
25 * ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
26 * OF THE POSSIBILITY OF SUCH DAMAGE.
28 * Alternatively, the contents of this file may be used under the terms of
29 * the GNU General Public License ("GPL") version 2 or any later version,
30 * in which case the provisions of the GPL are applicable instead of
31 * the above. If you wish to allow the use of your version of this file
32 * only under the terms of the GPL and not to allow others to use your
33 * version of this file under the BSD license, indicate your decision
34 * by deleting the provisions above and replace them with the notice
35 * and other provisions required by the GPL. If you do not delete the
36 * provisions above, a recipient may use your version of this file under
37 * either the BSD or the GPL.
49 #ifndef EV_USE_STDEXCEPT
50 # define EV_USE_STDEXCEPT 1
59 typedef ev_tstamp tstamp;
70 PERIODIC = EV_PERIODIC,
80 # undef ERROR // some systems stupidly #define ERROR
88 FORKCHECK = EVFLAG_FORKCHECK,
90 SELECT = EVBACKEND_SELECT,
91 POLL = EVBACKEND_POLL,
92 EPOLL = EVBACKEND_EPOLL,
93 KQUEUE = EVBACKEND_KQUEUE,
94 DEVPOLL = EVBACKEND_DEVPOLL,
101 NONBLOCK = EVLOOP_NONBLOCK,
102 ONESHOT = EVLOOP_ONESHOT,
104 NOWAIT = EVRUN_NOWAIT,
121 : std::runtime_error ("libev event loop cannot be initialized, bad value of LIBEV_FLAGS?")
136 # define EV_AX raw_loop
137 # define EV_AX_ raw_loop,
145 loop_ref (EV_P) throw ()
152 bool operator == (const loop_ref &other) const throw ()
155 return EV_AX == other.EV_AX;
161 bool operator != (const loop_ref &other) const throw ()
164 return ! (*this == other);
171 bool operator == (const EV_P) const throw ()
173 return this->EV_AX == EV_A;
176 bool operator != (const EV_P) const throw ()
178 return (*this == EV_A);
181 operator struct ev_loop * () const throw ()
186 operator const struct ev_loop * () const throw ()
191 bool is_default () const throw ()
193 return EV_AX == ev_default_loop (0);
198 void loop (int flags = 0)
200 ev_run (EV_AX_ flags);
203 void unloop (how_t how = ONE) throw ()
205 ev_break (EV_AX_ how);
209 void run (int flags = 0)
211 ev_run (EV_AX_ flags);
214 void break_loop (how_t how = ONE) throw ()
216 ev_break (EV_AX_ how);
219 void post_fork () throw ()
221 ev_loop_fork (EV_AX);
224 unsigned int backend () const throw ()
226 return ev_backend (EV_AX);
229 tstamp now () const throw ()
231 return ev_now (EV_AX);
239 void unref () throw ()
245 unsigned int iteration () const throw ()
247 return ev_iteration (EV_AX);
250 unsigned int depth () const throw ()
252 return ev_depth (EV_AX);
255 void set_io_collect_interval (tstamp interval) throw ()
257 ev_set_io_collect_interval (EV_AX_ interval);
260 void set_timeout_collect_interval (tstamp interval) throw ()
262 ev_set_timeout_collect_interval (EV_AX_ interval);
267 void once (int fd, int events, tstamp timeout, void (*cb)(int, void *), void *arg = 0) throw ()
269 ev_once (EV_AX_ fd, events, timeout, cb, arg);
273 template<class K, void (K::*method)(int)>
274 void once (int fd, int events, tstamp timeout, K *object) throw ()
276 once (fd, events, timeout, method_thunk<K, method>, object);
279 // default method == operator ()
281 void once (int fd, int events, tstamp timeout, K *object) throw ()
283 once (fd, events, timeout, method_thunk<K, &K::operator ()>, object);
286 template<class K, void (K::*method)(int)>
287 static void method_thunk (int revents, void *arg)
289 (static_cast<K *>(arg)->*method)
293 // no-argument method callback
294 template<class K, void (K::*method)()>
295 void once (int fd, int events, tstamp timeout, K *object) throw ()
297 once (fd, events, timeout, method_noargs_thunk<K, method>, object);
300 template<class K, void (K::*method)()>
301 static void method_noargs_thunk (int revents, void *arg)
303 (static_cast<K *>(arg)->*method)
307 // simpler function callback
308 template<void (*cb)(int)>
309 void once (int fd, int events, tstamp timeout) throw ()
311 once (fd, events, timeout, simpler_func_thunk<cb>);
314 template<void (*cb)(int)>
315 static void simpler_func_thunk (int revents, void *arg)
321 // simplest function callback
322 template<void (*cb)()>
323 void once (int fd, int events, tstamp timeout) throw ()
325 once (fd, events, timeout, simplest_func_thunk<cb>);
328 template<void (*cb)()>
329 static void simplest_func_thunk (int revents, void *arg)
335 void feed_fd_event (int fd, int revents) throw ()
337 ev_feed_fd_event (EV_AX_ fd, revents);
340 void feed_signal_event (int signum) throw ()
342 ev_feed_signal_event (EV_AX_ signum);
346 struct ev_loop* EV_AX;
352 struct dynamic_loop : loop_ref
355 dynamic_loop (unsigned int flags = AUTO) throw (bad_loop)
356 : loop_ref (ev_loop_new (flags))
362 ~dynamic_loop () throw ()
364 ev_loop_destroy (EV_AX);
370 dynamic_loop (const dynamic_loop &);
372 dynamic_loop & operator= (const dynamic_loop &);
377 struct default_loop : loop_ref
379 default_loop (unsigned int flags = AUTO) throw (bad_loop)
381 : loop_ref (ev_default_loop (flags))
388 !ev_default_loop (flags)
395 default_loop (const default_loop &);
396 default_loop &operator = (const default_loop &);
399 inline loop_ref get_default_loop () throw ()
402 return ev_default_loop (0);
414 # define EV_PX loop_ref EV_A
415 # define EV_PX_ loop_ref EV_A_
421 template<class ev_watcher, class watcher>
422 struct base : ev_watcher
428 void set (EV_P) throw ()
434 base (EV_PX) throw ()
442 void set_ (const void *data, void (*cb)(EV_P_ ev_watcher *w, int revents)) throw ()
444 this->data = (void *)data;
445 ev_set_cb (static_cast<ev_watcher *>(this), cb);
449 template<void (*function)(watcher &w, int)>
450 void set (void *data = 0) throw ()
452 set_ (data, function_thunk<function>);
455 template<void (*function)(watcher &w, int)>
456 static void function_thunk (EV_P_ ev_watcher *w, int revents)
459 (*static_cast<watcher *>(w), revents);
463 template<class K, void (K::*method)(watcher &w, int)>
464 void set (K *object) throw ()
466 set_ (object, method_thunk<K, method>);
469 // default method == operator ()
471 void set (K *object) throw ()
473 set_ (object, method_thunk<K, &K::operator ()>);
476 template<class K, void (K::*method)(watcher &w, int)>
477 static void method_thunk (EV_P_ ev_watcher *w, int revents)
479 (static_cast<K *>(w->data)->*method)
480 (*static_cast<watcher *>(w), revents);
483 // no-argument callback
484 template<class K, void (K::*method)()>
485 void set (K *object) throw ()
487 set_ (object, method_noargs_thunk<K, method>);
490 template<class K, void (K::*method)()>
491 static void method_noargs_thunk (EV_P_ ev_watcher *w, int revents)
493 (static_cast<K *>(w->data)->*method)
497 void operator ()(int events = EV_UNDEF)
500 ev_cb (static_cast<ev_watcher *>(this))
501 (static_cast<ev_watcher *>(this), events);
504 bool is_active () const throw ()
506 return ev_is_active (static_cast<const ev_watcher *>(this));
509 bool is_pending () const throw ()
511 return ev_is_pending (static_cast<const ev_watcher *>(this));
514 void feed_event (int revents) throw ()
516 ev_feed_event (EV_A_ static_cast<ev_watcher *>(this), revents);
520 inline tstamp now (EV_P) throw ()
522 return ev_now (EV_A);
525 inline void delay (tstamp interval) throw ()
530 inline int version_major () throw ()
532 return ev_version_major ();
535 inline int version_minor () throw ()
537 return ev_version_minor ();
540 inline unsigned int supported_backends () throw ()
542 return ev_supported_backends ();
545 inline unsigned int recommended_backends () throw ()
547 return ev_recommended_backends ();
550 inline unsigned int embeddable_backends () throw ()
552 return ev_embeddable_backends ();
555 inline void set_allocator (void *(*cb)(void *ptr, long size) throw ()) throw ()
557 ev_set_allocator (cb);
560 inline void set_syserr_cb (void (*cb)(const char *msg) throw ()) throw ()
562 ev_set_syserr_cb (cb);
566 #define EV_CONSTRUCT(cppstem,cstem) \
567 (EV_PX = get_default_loop ()) throw () \
568 : base<ev_ ## cstem, cppstem> (EV_A) \
572 #define EV_CONSTRUCT(cppstem,cstem) \
578 /* using a template here would require quite a few more lines,
579 * so a macro solution was chosen */
580 #define EV_BEGIN_WATCHER(cppstem,cstem) \
582 struct cppstem : base<ev_ ## cstem, cppstem> \
584 void start () throw () \
586 ev_ ## cstem ## _start (EV_A_ static_cast<ev_ ## cstem *>(this)); \
589 void stop () throw () \
591 ev_ ## cstem ## _stop (EV_A_ static_cast<ev_ ## cstem *>(this)); \
594 cppstem EV_CONSTRUCT(cppstem,cstem) \
596 ~cppstem () throw () \
601 using base<ev_ ## cstem, cppstem>::set; \
605 cppstem (const cppstem &o); \
607 cppstem &operator =(const cppstem &o); \
611 #define EV_END_WATCHER(cppstem,cstem) \
614 EV_BEGIN_WATCHER (io, io)
615 void set (int fd, int events) throw ()
617 int active = is_active ();
619 ev_io_set (static_cast<ev_io *>(this), fd, events);
620 if (active) start ();
623 void set (int events) throw ()
625 int active = is_active ();
627 ev_io_set (static_cast<ev_io *>(this), fd, events);
628 if (active) start ();
631 void start (int fd, int events) throw ()
636 EV_END_WATCHER (io, io)
638 EV_BEGIN_WATCHER (timer, timer)
639 void set (ev_tstamp after, ev_tstamp repeat = 0.) throw ()
641 int active = is_active ();
643 ev_timer_set (static_cast<ev_timer *>(this), after, repeat);
644 if (active) start ();
647 void start (ev_tstamp after, ev_tstamp repeat = 0.) throw ()
653 void again () throw ()
655 ev_timer_again (EV_A_ static_cast<ev_timer *>(this));
658 ev_tstamp remaining ()
660 return ev_timer_remaining (EV_A_ static_cast<ev_timer *>(this));
662 EV_END_WATCHER (timer, timer)
664 #if EV_PERIODIC_ENABLE
665 EV_BEGIN_WATCHER (periodic, periodic)
666 void set (ev_tstamp at, ev_tstamp interval = 0.) throw ()
668 int active = is_active ();
670 ev_periodic_set (static_cast<ev_periodic *>(this), at, interval, 0);
671 if (active) start ();
674 void start (ev_tstamp at, ev_tstamp interval = 0.) throw ()
680 void again () throw ()
682 ev_periodic_again (EV_A_ static_cast<ev_periodic *>(this));
684 EV_END_WATCHER (periodic, periodic)
688 EV_BEGIN_WATCHER (sig, signal)
689 void set (int signum) throw ()
691 int active = is_active ();
693 ev_signal_set (static_cast<ev_signal *>(this), signum);
694 if (active) start ();
697 void start (int signum) throw ()
702 EV_END_WATCHER (sig, signal)
706 EV_BEGIN_WATCHER (child, child)
707 void set (int pid, int trace = 0) throw ()
709 int active = is_active ();
711 ev_child_set (static_cast<ev_child *>(this), pid, trace);
712 if (active) start ();
715 void start (int pid, int trace = 0) throw ()
720 EV_END_WATCHER (child, child)
724 EV_BEGIN_WATCHER (stat, stat)
725 void set (const char *path, ev_tstamp interval = 0.) throw ()
727 int active = is_active ();
729 ev_stat_set (static_cast<ev_stat *>(this), path, interval);
730 if (active) start ();
733 void start (const char *path, ev_tstamp interval = 0.) throw ()
736 set (path, interval);
740 void update () throw ()
742 ev_stat_stat (EV_A_ static_cast<ev_stat *>(this));
744 EV_END_WATCHER (stat, stat)
748 EV_BEGIN_WATCHER (idle, idle)
749 void set () throw () { }
750 EV_END_WATCHER (idle, idle)
753 #if EV_PREPARE_ENABLE
754 EV_BEGIN_WATCHER (prepare, prepare)
755 void set () throw () { }
756 EV_END_WATCHER (prepare, prepare)
760 EV_BEGIN_WATCHER (check, check)
761 void set () throw () { }
762 EV_END_WATCHER (check, check)
766 EV_BEGIN_WATCHER (embed, embed)
767 void set_embed (struct ev_loop *embedded_loop) throw ()
769 int active = is_active ();
771 ev_embed_set (static_cast<ev_embed *>(this), embedded_loop);
772 if (active) start ();
775 void start (struct ev_loop *embedded_loop) throw ()
783 ev_embed_sweep (EV_A_ static_cast<ev_embed *>(this));
785 EV_END_WATCHER (embed, embed)
789 EV_BEGIN_WATCHER (fork, fork)
790 void set () throw () { }
791 EV_END_WATCHER (fork, fork)
795 EV_BEGIN_WATCHER (async, async)
796 void send () throw ()
798 ev_async_send (EV_A_ static_cast<ev_async *>(this));
801 bool async_pending () throw ()
803 return ev_async_pending (static_cast<ev_async *>(this));
805 EV_END_WATCHER (async, async)
811 #undef EV_BEGIN_WATCHER
812 #undef EV_END_WATCHER