2 * libev simple C++ wrapper classes
4 * Copyright (c) 2007 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_CXX_EXCEPTIONS
50 #define EV_CXX_EXCEPTIONS 1
56 # define EV_THROW(exception) throw (exception)
58 # define EV_THROW(exception)
63 typedef ev_tstamp tstamp;
71 PERIODIC = EV_PERIODIC,
87 FORKCHECK = EVFLAG_FORKCHECK,
88 SELECT = EVBACKEND_SELECT,
89 POLL = EVBACKEND_POLL,
90 EPOLL = EVBACKEND_EPOLL,
91 KQUEUE = EVBACKEND_KQUEUE,
92 DEVPOLL = EVBACKEND_DEVPOLL,
98 NONBLOCK = EVLOOP_NONBLOCK,
99 ONESHOT = EVLOOP_ONESHOT
108 #if EV_CXX_EXCEPTIONS
109 struct bad_loop : std::runtime_error
112 : std::runtime_error ("loop can't be initialized")
127 # define EV_AX raw_loop
128 # define EV_AX_ raw_loop,
139 EV_THROW (bad_loop) : EV_AX (EV_A)
142 #if EV_MULTIPLICIY && EV_CXX_EXCEPTIONS
148 bool operator== (const loop_ref &other) const throw ()
151 return this->EV_AX == other.EV_AX;
157 bool operator!= (const loop_ref &other) const throw ()
160 return ! (*this == other);
167 bool operator== (struct ev_loop *other) const throw ()
169 return this->EV_AX == other;
172 bool operator!= (struct ev_loop *other) const throw ()
174 return ! (*this == other);
177 bool operator== (const struct ev_loop *other) const throw ()
179 return this->EV_AX == other;
182 bool operator!= (const struct ev_loop *other) const throw ()
184 return (*this == other);
187 operator struct ev_loop * () const throw ()
192 operator const struct ev_loop * () const throw ()
197 bool is_default () const throw ()
199 return EV_AX == ev_default_loop (0);
203 void loop (int flags = 0)
205 ev_loop (EV_AX_ flags);
208 void unloop (how_t how = ONE) throw ()
210 ev_unloop (EV_AX_ how);
213 void post_fork () throw ()
216 ev_loop_fork (EV_AX);
222 unsigned int count () const throw ()
224 return ev_loop_count (EV_AX);
227 unsigned int backend () const throw ()
229 return ev_backend (EV_AX);
232 tstamp now () const throw ()
234 return ev_now (EV_AX);
242 void unref () throw ()
247 void set_io_collect_interval (tstamp interval) throw ()
249 ev_set_io_collect_interval (EV_AX_ interval);
252 void set_timeout_collect_interval (tstamp interval) throw ()
254 ev_set_timeout_collect_interval (EV_AX_ interval);
258 void once (int fd, int events, tstamp timeout, void (*cb)(int, void *), void* arg = 0) throw ()
260 ev_once (EV_AX_ fd, events, timeout, cb, arg);
264 template<class K, void (K::*method)(int)>
265 void once (int fd, int events, tstamp timeout, K *object) throw ()
267 once (fd, events, timeout, method_thunk<K, method>, object);
270 template<class K, void (K::*method)(int)>
271 static void method_thunk (int revents, void* arg)
273 K *obj = static_cast<K *>(arg);
274 (obj->*method) (revents);
277 // const method callback
278 template<class K, void (K::*method)(int) const>
279 void once (int fd, int events, tstamp timeout, const K *object) throw ()
281 once (fd, events, timeout, const_method_thunk<K, method>, object);
284 template<class K, void (K::*method)(int) const>
285 static void const_method_thunk (int revents, void* arg)
287 K *obj = static_cast<K *>(arg);
288 (obj->*method) (revents);
291 // simple method callback
292 template<class K, void (K::*method)()>
293 void once (int fd, int events, tstamp timeout, K *object) throw ()
295 once (fd, events, timeout, method_noargs_thunk<K, method>, object);
298 template<class K, void (K::*method)()>
299 static void method_noargs_thunk (int revents, void* arg)
301 K *obj = static_cast<K *>(arg);
305 // simpler function callback
306 template<void (*cb)(int)>
307 void once (int fd, int events, tstamp timeout) throw ()
309 once (fd, events, timeout, simpler_func_thunk<cb>);
312 template<void (*cb)(int)>
313 static void simpler_func_thunk (int revents, void* arg)
318 // simplest function callback
319 template<void (*cb)()>
320 void once (int fd, int events, tstamp timeout) throw ()
322 once (fd, events, timeout, simplest_func_thunk<cb>);
325 template<void (*cb)()>
326 static void simplest_func_thunk (int revents, void* arg)
331 void feed_fd_event (int fd, int revents) throw ()
333 ev_feed_fd_event (EV_AX_ fd, revents);
336 void feed_signal_event (int signum) throw ()
338 ev_feed_signal_event (EV_AX_ signum);
342 struct ev_loop* EV_AX;
348 struct dynamic_loop: loop_ref
351 dynamic_loop (unsigned int flags = AUTO) EV_THROW (bad_loop)
352 : loop_ref (ev_loop_new (flags))
356 ~dynamic_loop () throw ()
358 ev_loop_destroy (EV_AX);
364 dynamic_loop (const dynamic_loop &);
366 dynamic_loop & operator= (const dynamic_loop &);
371 struct default_loop: loop_ref
374 default_loop (unsigned int flags = AUTO) EV_THROW (bad_loop)
376 : loop_ref (ev_default_loop (flags))
381 #if EV_CXX_EXCEPTIONS
384 ev_default_loop (flags);
385 #if EV_CXX_EXCEPTIONS
392 ~default_loop () throw ()
394 ev_default_destroy ();
402 default_loop (const default_loop &);
404 default_loop & operator= (const default_loop &);
408 inline loop_ref get_default_loop () throw ()
411 return ev_default_loop (0);
423 # define EV_PX loop_ref EV_A
424 # define EV_PX_ loop_ref EV_A_
430 template<class ev_watcher, class watcher>
431 struct base : ev_watcher
436 void set (EV_PX) throw ()
442 base (EV_PX) throw ()
450 void set_ (void *data, void (*cb)(EV_P_ ev_watcher *w, int revents)) throw ()
453 ev_set_cb (static_cast<ev_watcher *>(this), cb);
457 template<class K, void (K::*method)(watcher &w, int)>
458 void set (K *object) throw ()
460 set_ (object, method_thunk<K, method>);
463 template<class K, void (K::*method)(watcher &w, int)>
464 static void method_thunk (EV_P_ ev_watcher *w, int revents)
466 K *obj = static_cast<K *>(w->data);
467 (obj->*method) (*static_cast<watcher *>(w), revents);
470 // const method callback
471 template<class K, void (K::*method)(watcher &w, int) const>
472 void set (const K *object) throw ()
474 set_ (object, const_method_thunk<K, method>);
477 template<class K, void (K::*method)(watcher &w, int) const>
478 static void const_method_thunk (EV_P_ ev_watcher *w, int revents)
480 K *obj = static_cast<K *>(w->data);
481 (static_cast<K *>(w->data)->*method) (*static_cast<watcher *>(w), revents);
485 template<void (*function)(watcher &w, int)>
486 void set (void *data = 0) throw ()
488 set_ (data, function_thunk<function>);
491 template<void (*function)(watcher &w, int)>
492 static void function_thunk (EV_P_ ev_watcher *w, int revents)
494 function (*static_cast<watcher *>(w), revents);
498 template<class K, void (K::*method)()>
499 void set (K *object) throw ()
501 set_ (object, method_noargs_thunk<K, method>);
504 template<class K, void (K::*method)()>
505 static void method_noargs_thunk (EV_P_ ev_watcher *w, int revents)
507 K *obj = static_cast<K *>(w->data);
511 void operator ()(int events = EV_UNDEF)
513 return ev_cb (static_cast<ev_watcher *>(this))
514 (static_cast<ev_watcher *>(this), events);
517 bool is_active () const throw ()
519 return ev_is_active (static_cast<const ev_watcher *>(this));
522 bool is_pending () const throw ()
524 return ev_is_pending (static_cast<const ev_watcher *>(this));
527 void feed_event (int revents) throw ()
529 ev_feed_event (EV_A_ static_cast<const ev_watcher *>(this), revents);
533 inline tstamp now () throw ()
538 inline void delay (tstamp interval) throw ()
543 inline int version_major () throw ()
545 return ev_version_major ();
548 inline int version_minor () throw ()
550 return ev_version_minor ();
553 inline unsigned int supported_backends () throw ()
555 return ev_supported_backends ();
558 inline unsigned int recommended_backends () throw ()
560 return ev_recommended_backends ();
563 inline unsigned int embeddable_backends () throw ()
565 return ev_embeddable_backends ();
568 inline void set_allocator (void *(*cb)(void *ptr, long size)) throw ()
570 ev_set_allocator (cb);
573 inline void set_syserr_cb (void (*cb)(const char *msg)) throw ()
575 ev_set_syserr_cb (cb);
579 #define EV_CONSTRUCT(cppstem,cstem) \
580 (EV_PX = get_default_loop ()) throw () \
581 : base<ev_ ## cstem, cppstem> (EV_A) \
585 #define EV_CONSTRUCT(cppstem,cstem) \
591 /* using a template here would require quite a bit more lines,
592 * so a macro solution was chosen */
593 #define EV_BEGIN_WATCHER(cppstem,cstem) \
595 struct cppstem : base<ev_ ## cstem, cppstem> \
597 void start () throw () \
599 ev_ ## cstem ## _start (EV_A_ static_cast<ev_ ## cstem *>(this)); \
602 void stop () throw () \
604 ev_ ## cstem ## _stop (EV_A_ static_cast<ev_ ## cstem *>(this)); \
607 cppstem EV_CONSTRUCT(cppstem,cstem) \
609 ~cppstem () throw () \
614 using base<ev_ ## cstem, cppstem>::set; \
618 cppstem (const cppstem &o); \
620 cppstem & operator =(const cppstem &o); \
624 #define EV_END_WATCHER(cppstem,cstem) \
627 EV_BEGIN_WATCHER (io, io)
628 void set (int fd, int events) throw ()
630 int active = is_active ();
632 ev_io_set (static_cast<ev_io *>(this), fd, events);
633 if (active) start ();
636 void set (int events) throw ()
638 int active = is_active ();
640 ev_io_set (static_cast<ev_io *>(this), fd, events);
641 if (active) start ();
644 void start (int fd, int events) throw ()
649 EV_END_WATCHER (io, io)
651 EV_BEGIN_WATCHER (timer, timer)
652 void set (ev_tstamp after, ev_tstamp repeat = 0.) throw ()
654 int active = is_active ();
656 ev_timer_set (static_cast<ev_timer *>(this), after, repeat);
657 if (active) start ();
660 void start (ev_tstamp after, ev_tstamp repeat = 0.) throw ()
666 void again () throw ()
668 ev_timer_again (EV_A_ static_cast<ev_timer *>(this));
670 EV_END_WATCHER (timer, timer)
672 #if EV_PERIODIC_ENABLE
673 EV_BEGIN_WATCHER (periodic, periodic)
674 void set (ev_tstamp at, ev_tstamp interval = 0.) throw ()
676 int active = is_active ();
678 ev_periodic_set (static_cast<ev_periodic *>(this), at, interval, 0);
679 if (active) start ();
682 void start (ev_tstamp at, ev_tstamp interval = 0.) throw ()
688 void again () throw ()
690 ev_periodic_again (EV_A_ static_cast<ev_periodic *>(this));
692 EV_END_WATCHER (periodic, periodic)
695 EV_BEGIN_WATCHER (sig, signal)
696 void set (int signum) throw ()
698 int active = is_active ();
700 ev_signal_set (static_cast<ev_signal *>(this), signum);
701 if (active) start ();
704 void start (int signum) throw ()
709 EV_END_WATCHER (sig, signal)
711 EV_BEGIN_WATCHER (child, child)
712 void set (int pid) throw ()
714 int active = is_active ();
716 ev_child_set (static_cast<ev_child *>(this), pid);
717 if (active) start ();
720 void start (int pid) throw ()
725 EV_END_WATCHER (child, child)
728 EV_BEGIN_WATCHER (stat, stat)
729 void set (const char *path, ev_tstamp interval = 0.) throw ()
731 int active = is_active ();
733 ev_stat_set (static_cast<ev_stat *>(this), path, interval);
734 if (active) start ();
737 void start (const char *path, ev_tstamp interval = 0.) throw ()
740 set (path, interval);
744 void update () throw ()
746 ev_stat_stat (EV_A_ static_cast<ev_stat *>(this));
748 EV_END_WATCHER (stat, stat)
751 EV_BEGIN_WATCHER (idle, idle)
752 void set () throw () { }
753 EV_END_WATCHER (idle, idle)
755 EV_BEGIN_WATCHER (prepare, prepare)
756 void set () throw () { }
757 EV_END_WATCHER (prepare, prepare)
759 EV_BEGIN_WATCHER (check, check)
760 void set () throw () { }
761 EV_END_WATCHER (check, check)
764 EV_BEGIN_WATCHER (embed, embed)
765 void start (struct ev_loop *embedded_loop) throw ()
768 ev_embed_set (static_cast<ev_embed *>(this), embedded_loop);
774 ev_embed_sweep (EV_A_ static_cast<ev_embed *>(this));
776 EV_END_WATCHER (embed, embed)
780 EV_BEGIN_WATCHER (fork, fork)
781 void set () throw () { }
782 EV_END_WATCHER (fork, fork)
788 #undef EV_BEGIN_WATCHER
789 #undef EV_END_WATCHER