libev/ev%2B%2B.h

/*
 * libev simple C++ wrapper classes
 *
 * Copyright (c) 2007,2008,2010,2018,2020 Marc Alexander Lehmann <libev@schmorp.de>
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modifica-
 * tion, are permitted provided that the following conditions are met:
 *
 *   1.  Redistributions of source code must retain the above copyright notice,
 *       this list of conditions and the following disclaimer.
 *
 *   2.  Redistributions in binary form must reproduce the above copyright
 *       notice, this list of conditions and the following disclaimer in the
 *       documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MER-
 * CHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPE-
 * CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTH-
 * ERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * Alternatively, the contents of this file may be used under the terms of
 * the GNU General Public License ("GPL") version 2 or any later version,
 * in which case the provisions of the GPL are applicable instead of
 * the above. If you wish to allow the use of your version of this file
 * only under the terms of the GPL and not to allow others to use your
 * version of this file under the BSD license, indicate your decision
 * by deleting the provisions above and replace them with the notice
 * and other provisions required by the GPL. If you do not delete the
 * provisions above, a recipient may use your version of this file under
 * either the BSD or the GPL.
 */

#ifndef EVPP_H__
#define EVPP_H__

#ifdef EV_H
# include EV_H
#else
# include "ev.h"
#endif

#ifndef EV_USE_STDEXCEPT
# define EV_USE_STDEXCEPT 1
#endif

#if EV_USE_STDEXCEPT
# include <stdexcept>
#endif

namespace ev {

  typedef ev_tstamp tstamp;

  enum {
    UNDEF    = EV_UNDEF,
    NONE     = EV_NONE,
    READ     = EV_READ,
    WRITE    = EV_WRITE,
#if EV_COMPAT3
    TIMEOUT  = EV_TIMEOUT,
#endif
    TIMER    = EV_TIMER,
    PERIODIC = EV_PERIODIC,
    SIGNAL   = EV_SIGNAL,
    CHILD    = EV_CHILD,
    STAT     = EV_STAT,
    IDLE     = EV_IDLE,
    CHECK    = EV_CHECK,
    PREPARE  = EV_PREPARE,
    FORK     = EV_FORK,
    ASYNC    = EV_ASYNC,
    EMBED    = EV_EMBED,
#   undef ERROR // some systems stupidly #define ERROR
    ERROR    = EV_ERROR
  };

  enum
  {
    AUTO      = EVFLAG_AUTO,
    NOENV     = EVFLAG_NOENV,
    FORKCHECK = EVFLAG_FORKCHECK,

    SELECT    = EVBACKEND_SELECT,
    POLL      = EVBACKEND_POLL,
    EPOLL     = EVBACKEND_EPOLL,
    KQUEUE    = EVBACKEND_KQUEUE,
    DEVPOLL   = EVBACKEND_DEVPOLL,
    PORT      = EVBACKEND_PORT
  };

  enum
  {
#if EV_COMPAT3
    NONBLOCK = EVLOOP_NONBLOCK,
    ONESHOT  = EVLOOP_ONESHOT,
#endif
    NOWAIT   = EVRUN_NOWAIT,
    ONCE     = EVRUN_ONCE
  };

  enum how_t
  {
    ONE = EVBREAK_ONE,
    ALL = EVBREAK_ALL
  };

  struct bad_loop
#if EV_USE_STDEXCEPT
  : std::exception
#endif
  {
#if EV_USE_STDEXCEPT
    const char *what () const EV_NOEXCEPT
    {
      return "libev event loop cannot be initialized, bad value of LIBEV_FLAGS?";
    }
#endif
  };

#ifdef EV_AX
#  undef EV_AX
#endif

#ifdef EV_AX_
#  undef EV_AX_
#endif

#if EV_MULTIPLICITY
#  define EV_AX  raw_loop
#  define EV_AX_ raw_loop,
#else
#  define EV_AX
#  define EV_AX_
#endif

  struct loop_ref
  {
    loop_ref (EV_P) EV_NOEXCEPT
#if EV_MULTIPLICITY
    : EV_AX (EV_A)
#endif
    {
    }

    bool operator == (const loop_ref &other) const EV_NOEXCEPT
    {
#if EV_MULTIPLICITY
      return EV_AX == other.EV_AX;
#else
      return true;
#endif
    }

    bool operator != (const loop_ref &other) const EV_NOEXCEPT
    {
#if EV_MULTIPLICITY
      return ! (*this == other);
#else
      return false;
#endif
    }

#if EV_MULTIPLICITY
    bool operator == (const EV_P) const EV_NOEXCEPT
    {
      return this->EV_AX == EV_A;
    }

    bool operator != (const EV_P) const EV_NOEXCEPT
    {
      return ! (*this == EV_A);
    }

    operator struct ev_loop * () const EV_NOEXCEPT
    {
      return EV_AX;
    }

    operator const struct ev_loop * () const EV_NOEXCEPT
    {
      return EV_AX;
    }

    bool is_default () const EV_NOEXCEPT
    {
      return EV_AX == ev_default_loop (0);
    }
#endif

#if EV_COMPAT3
    void loop (int flags = 0)
    {
      ev_run (EV_AX_ flags);
    }

    void unloop (how_t how = ONE) EV_NOEXCEPT
    {
      ev_break (EV_AX_ how);
    }
#endif

    void run (int flags = 0)
    {
      ev_run (EV_AX_ flags);
    }

    void break_loop (how_t how = ONE) EV_NOEXCEPT
    {
      ev_break (EV_AX_ how);
    }

    void post_fork () EV_NOEXCEPT
    {
      ev_loop_fork (EV_AX);
    }

    unsigned int backend () const EV_NOEXCEPT
    {
      return ev_backend (EV_AX);
    }

    tstamp now () const EV_NOEXCEPT
    {
      return ev_now (EV_AX);
    }

    void ref () EV_NOEXCEPT
    {
      ev_ref (EV_AX);
    }

    void unref () EV_NOEXCEPT
    {
      ev_unref (EV_AX);
    }

#if EV_FEATURE_API
    unsigned int iteration () const EV_NOEXCEPT
    {
      return ev_iteration (EV_AX);
    }

    unsigned int depth () const EV_NOEXCEPT
    {
      return ev_depth (EV_AX);
    }

    void set_io_collect_interval (tstamp interval) EV_NOEXCEPT
    {
      ev_set_io_collect_interval (EV_AX_ interval);
    }

    void set_timeout_collect_interval (tstamp interval) EV_NOEXCEPT
    {
      ev_set_timeout_collect_interval (EV_AX_ interval);
    }
#endif

    // function callback
    void once (int fd, int events, tstamp timeout, void (*cb)(int, void *), void *arg = 0) EV_NOEXCEPT
    {
      ev_once (EV_AX_ fd, events, timeout, cb, arg);
    }

    // method callback
    template<class K, void (K::*method)(int)>
    void once (int fd, int events, tstamp timeout, K *object) EV_NOEXCEPT
    {
      once (fd, events, timeout, method_thunk<K, method>, object);
    }

    // default method == operator ()
    template<class K>
    void once (int fd, int events, tstamp timeout, K *object) EV_NOEXCEPT
    {
      once (fd, events, timeout, method_thunk<K, &K::operator ()>, object);
    }

    template<class K, void (K::*method)(int)>
    static void method_thunk (int revents, void *arg)
    {
      (static_cast<K *>(arg)->*method)
        (revents);
    }

    // no-argument method callback
    template<class K, void (K::*method)()>
    void once (int fd, int events, tstamp timeout, K *object) EV_NOEXCEPT
    {
      once (fd, events, timeout, method_noargs_thunk<K, method>, object);
    }

    template<class K, void (K::*method)()>
    static void method_noargs_thunk (int revents, void *arg)
    {
      (static_cast<K *>(arg)->*method)
        ();
    }

    // simpler function callback
    template<void (*cb)(int)>
    void once (int fd, int events, tstamp timeout) EV_NOEXCEPT
    {
      once (fd, events, timeout, simpler_func_thunk<cb>);
    }

    template<void (*cb)(int)>
    static void simpler_func_thunk (int revents, void *arg)
    {
      (*cb)
        (revents);
    }

    // simplest function callback
    template<void (*cb)()>
    void once (int fd, int events, tstamp timeout) EV_NOEXCEPT
    {
      once (fd, events, timeout, simplest_func_thunk<cb>);
    }

    template<void (*cb)()>
    static void simplest_func_thunk (int revents, void *arg)
    {
      (*cb)
        ();
    }

    void feed_fd_event (int fd, int revents) EV_NOEXCEPT
    {
      ev_feed_fd_event (EV_AX_ fd, revents);
    }

    void feed_signal_event (int signum) EV_NOEXCEPT
    {
      ev_feed_signal_event (EV_AX_ signum);
    }

#if EV_MULTIPLICITY
    struct ev_loop* EV_AX;
#endif

  };

#if EV_MULTIPLICITY
  struct dynamic_loop : loop_ref
  {

    dynamic_loop (unsigned int flags = AUTO)
    : loop_ref (ev_loop_new (flags))
    {
      if (!EV_AX)
        throw bad_loop ();
    }

    ~dynamic_loop () EV_NOEXCEPT
    {
      ev_loop_destroy (EV_AX);
      EV_AX = 0;
    }

  private:

    dynamic_loop (const dynamic_loop &);

    dynamic_loop & operator= (const dynamic_loop &);

  };
#endif

  struct default_loop : loop_ref
  {
    default_loop (unsigned int flags = AUTO)
#if EV_MULTIPLICITY
    : loop_ref (ev_default_loop (flags))
#endif
    {
      if (
#if EV_MULTIPLICITY
          !EV_AX
#else
          !ev_default_loop (flags)
#endif
      )
        throw bad_loop ();
    }

  private:
    default_loop (const default_loop &);
    default_loop &operator = (const default_loop &);
  };

  inline loop_ref get_default_loop () EV_NOEXCEPT
  {
#if EV_MULTIPLICITY
    return ev_default_loop (0);
#else
    return loop_ref ();
#endif
  }

#undef EV_AX
#undef EV_AX_

#undef EV_PX
#undef EV_PX_
#if EV_MULTIPLICITY
#  define EV_PX  loop_ref EV_A
#  define EV_PX_ loop_ref EV_A_
#else
#  define EV_PX
#  define EV_PX_
#endif

  template<class ev_watcher, class watcher>
  struct base : ev_watcher
  {
    // scoped pause/unpause of a watcher
    struct freeze_guard
    {
      watcher &w;
      bool active;

      freeze_guard (watcher *self) EV_NOEXCEPT
      : w (*self), active (w.is_active ())
      {
        if (active) w.stop ();
      }

      ~freeze_guard ()
      {
        if (active) w.start ();
      }
    };

    #if EV_MULTIPLICITY
      EV_PX;

      // loop set
      void set (EV_P) EV_NOEXCEPT
      {
        this->EV_A = EV_A;
      }
    #endif

    base (EV_PX) EV_NOEXCEPT
    #if EV_MULTIPLICITY
      : EV_A (EV_A)
    #endif
    {
      ev_init (this, 0);
    }

    void set_ (const void *data, void (*cb)(EV_P_ ev_watcher *w, int revents)) EV_NOEXCEPT
    {
      this->data = (void *)data;
      ev_set_cb (static_cast<ev_watcher *>(this), cb);
    }

    // function callback
    template<void (*function)(watcher &w, int)>
    void set (void *data = 0) EV_NOEXCEPT
    {
      set_ (data, function_thunk<function>);
    }

    template<void (*function)(watcher &w, int)>
    static void function_thunk (EV_P_ ev_watcher *w, int revents)
    {
      function
        (*static_cast<watcher *>(w), revents);
    }

    // method callback
    template<class K, void (K::*method)(watcher &w, int)>
    void set (K *object) EV_NOEXCEPT
    {
      set_ (object, method_thunk<K, method>);
    }

    // default method == operator ()
    template<class K>
    void set (K *object) EV_NOEXCEPT
    {
      set_ (object, method_thunk<K, &K::operator ()>);
    }

    template<class K, void (K::*method)(watcher &w, int)>
    static void method_thunk (EV_P_ ev_watcher *w, int revents)
    {
      (static_cast<K *>(w->data)->*method)
        (*static_cast<watcher *>(w), revents);
    }

    // no-argument callback
    template<class K, void (K::*method)()>
    void set (K *object) EV_NOEXCEPT
    {
      set_ (object, method_noargs_thunk<K, method>);
    }

    template<class K, void (K::*method)()>
    static void method_noargs_thunk (EV_P_ ev_watcher *w, int revents)
    {
      (static_cast<K *>(w->data)->*method)
        ();
    }

    void operator ()(int events = EV_UNDEF)
    {
      return
        ev_cb (static_cast<ev_watcher *>(this))
          (static_cast<ev_watcher *>(this), events);
    }

    bool is_active () const EV_NOEXCEPT
    {
      return ev_is_active (static_cast<const ev_watcher *>(this));
    }

    bool is_pending () const EV_NOEXCEPT
    {
      return ev_is_pending (static_cast<const ev_watcher *>(this));
    }

    void feed_event (int revents) EV_NOEXCEPT
    {
      ev_feed_event (EV_A_ static_cast<ev_watcher *>(this), revents);
    }
  };

  inline tstamp now (EV_P) EV_NOEXCEPT
  {
    return ev_now (EV_A);
  }

  inline void delay (tstamp interval) EV_NOEXCEPT
  {
    ev_sleep (interval);
  }

  inline int version_major () EV_NOEXCEPT
  {
    return ev_version_major ();
  }

  inline int version_minor () EV_NOEXCEPT
  {
    return ev_version_minor ();
  }

  inline unsigned int supported_backends () EV_NOEXCEPT
  {
    return ev_supported_backends ();
  }

  inline unsigned int recommended_backends () EV_NOEXCEPT
  {
    return ev_recommended_backends ();
  }

  inline unsigned int embeddable_backends () EV_NOEXCEPT
  {
    return ev_embeddable_backends ();
  }

  inline void set_allocator (void *(*cb)(void *ptr, long size) EV_NOEXCEPT) EV_NOEXCEPT
  {
    ev_set_allocator (cb);
  }

  inline void set_syserr_cb (void (*cb)(const char *msg) EV_NOEXCEPT) EV_NOEXCEPT
  {
    ev_set_syserr_cb (cb);
  }

  #if EV_MULTIPLICITY
    #define EV_CONSTRUCT(cppstem,cstem)                                                 \
      (EV_PX = get_default_loop ()) EV_NOEXCEPT                                         \
        : base<ev_ ## cstem, cppstem> (EV_A)                                            \
      {                                                                                 \
      }
  #else
    #define EV_CONSTRUCT(cppstem,cstem)                                                 \
      () EV_NOEXCEPT                                                                    \
      {                                                                                 \
      }
  #endif

  /* using a template here would require quite a few more lines,
   * so a macro solution was chosen */
  #define EV_BEGIN_WATCHER(cppstem,cstem)                                               \
                                                                                        \
  struct cppstem : base<ev_ ## cstem, cppstem>                                          \
  {                                                                                     \
    void start () EV_NOEXCEPT                                                           \
    {                                                                                   \
      ev_ ## cstem ## _start (EV_A_ static_cast<ev_ ## cstem *>(this));                 \
    }                                                                                   \
                                                                                        \
    void stop () EV_NOEXCEPT                                                            \
    {                                                                                   \
      ev_ ## cstem ## _stop (EV_A_ static_cast<ev_ ## cstem *>(this));                  \
    }                                                                                   \
                                                                                        \
    cppstem EV_CONSTRUCT(cppstem,cstem)                                                 \
                                                                                        \
    ~cppstem () EV_NOEXCEPT                                                             \
    {                                                                                   \
      stop ();                                                                          \
    }                                                                                   \
                                                                                        \
    using base<ev_ ## cstem, cppstem>::set;                                             \
                                                                                        \
  private:                                                                              \
                                                                                        \
    cppstem (const cppstem &o);                                                         \
                                                                                        \
    cppstem &operator =(const cppstem &o);                                              \
                                                                                        \
  public:

  #define EV_END_WATCHER(cppstem,cstem)                                                 \
  };
  //TODO: https://paste.debian.net/1268417/

  EV_BEGIN_WATCHER (io, io)
    void set (int fd, int events) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_io_set (static_cast<ev_io *>(this), fd, events);
    }

    void set (int events) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_io_modify (static_cast<ev_io *>(this), events);
    }

    void start (int fd, int events) EV_NOEXCEPT
    {
      set (fd, events);
      start ();
    }
  EV_END_WATCHER (io, io)

  EV_BEGIN_WATCHER (timer, timer)
    void set (ev_tstamp after, ev_tstamp repeat = 0.) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_timer_set (static_cast<ev_timer *>(this), after, repeat);
    }

    void start (ev_tstamp after, ev_tstamp repeat = 0.) EV_NOEXCEPT
    {
      set (after, repeat);
      start ();
    }

    void again () EV_NOEXCEPT
    {
      ev_timer_again (EV_A_ static_cast<ev_timer *>(this));
    }

    ev_tstamp remaining ()
    {
      return ev_timer_remaining (EV_A_ static_cast<ev_timer *>(this));
    }
  EV_END_WATCHER (timer, timer)

  #if EV_PERIODIC_ENABLE
  EV_BEGIN_WATCHER (periodic, periodic)
    void set (ev_tstamp at, ev_tstamp interval = 0.) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_periodic_set (static_cast<ev_periodic *>(this), at, interval, 0);
    }

    void start (ev_tstamp at, ev_tstamp interval = 0.) EV_NOEXCEPT
    {
      set (at, interval);
      start ();
    }

    void again () EV_NOEXCEPT
    {
      ev_periodic_again (EV_A_ static_cast<ev_periodic *>(this));
    }
  EV_END_WATCHER (periodic, periodic)
  #endif

  #if EV_SIGNAL_ENABLE
  EV_BEGIN_WATCHER (sig, signal)
    void set (int signum) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_signal_set (static_cast<ev_signal *>(this), signum);
    }

    void start (int signum) EV_NOEXCEPT
    {
      set (signum);
      start ();
    }
  EV_END_WATCHER (sig, signal)
  #endif

  #if EV_CHILD_ENABLE
  EV_BEGIN_WATCHER (child, child)
    void set (int pid, int trace = 0) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_child_set (static_cast<ev_child *>(this), pid, trace);
    }

    void start (int pid, int trace = 0) EV_NOEXCEPT
    {
      set (pid, trace);
      start ();
    }
  EV_END_WATCHER (child, child)
  #endif

  #if EV_STAT_ENABLE
  EV_BEGIN_WATCHER (stat, stat)
    void set (const char *path, ev_tstamp interval = 0.) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_stat_set (static_cast<ev_stat *>(this), path, interval);
    }

    void start (const char *path, ev_tstamp interval = 0.) EV_NOEXCEPT
    {
      stop ();
      set (path, interval);
      start ();
    }

    void update () EV_NOEXCEPT
    {
      ev_stat_stat (EV_A_ static_cast<ev_stat *>(this));
    }
  EV_END_WATCHER (stat, stat)
  #endif

  #if EV_IDLE_ENABLE
  EV_BEGIN_WATCHER (idle, idle)
    void set () EV_NOEXCEPT { }
  EV_END_WATCHER (idle, idle)
  #endif

  #if EV_PREPARE_ENABLE
  EV_BEGIN_WATCHER (prepare, prepare)
    void set () EV_NOEXCEPT { }
  EV_END_WATCHER (prepare, prepare)
  #endif

  #if EV_CHECK_ENABLE
  EV_BEGIN_WATCHER (check, check)
    void set () EV_NOEXCEPT { }
  EV_END_WATCHER (check, check)
  #endif

  #if EV_EMBED_ENABLE
  EV_BEGIN_WATCHER (embed, embed)
    void set_embed (struct ev_loop *embedded_loop) EV_NOEXCEPT
    {
      freeze_guard freeze (this);
      ev_embed_set (static_cast<ev_embed *>(this), embedded_loop);
    }

    void start (struct ev_loop *embedded_loop) EV_NOEXCEPT
    {
      set (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_NOEXCEPT { }
  EV_END_WATCHER (fork, fork)
  #endif

  #if EV_ASYNC_ENABLE
  EV_BEGIN_WATCHER (async, async)
    void send () EV_NOEXCEPT
    {
      ev_async_send (EV_A_ static_cast<ev_async *>(this));
    }

    bool async_pending () EV_NOEXCEPT
    {
      return ev_async_pending (static_cast<ev_async *>(this));
    }
  EV_END_WATCHER (async, async)
  #endif

  #undef EV_PX
  #undef EV_PX_
  #undef EV_CONSTRUCT
  #undef EV_BEGIN_WATCHER
  #undef EV_END_WATCHER
}

#endif

Revision:	1.69
Committed:	Sat Jun 3 08:53:03 2023 UTC (10 months, 3 weeks ago) by root
Content type:	text/plain
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.68:	+1 -0 lines
Log Message:	* empty log message *
#	Content
1	/*
2	* libev simple C++ wrapper classes
3	*
4	* Copyright (c) 2007,2008,2010,2018,2020 Marc Alexander Lehmann <libev@schmorp.de>
5	* All rights reserved.
6	*
7	* Redistribution and use in source and binary forms, with or without modifica-
8	* tion, are permitted provided that the following conditions are met:
9	*
10	* 1. Redistributions of source code must retain the above copyright notice,
11	* this list of conditions and the following disclaimer.
12	*
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.
16	*
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.
27	*
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.
38	*/
39
40	#ifndef EVPP_H__
41	#define EVPP_H__
42
43	#ifdef EV_H
44	# include EV_H
45	#else
46	# include "ev.h"
47	#endif
48
49	#ifndef EV_USE_STDEXCEPT
50	# define EV_USE_STDEXCEPT 1
51	#endif
52
53	#if EV_USE_STDEXCEPT
54	# include <stdexcept>
55	#endif
56
57	namespace ev {
58
59	typedef ev_tstamp tstamp;
60
61	enum {
62	UNDEF = EV_UNDEF,
63	NONE = EV_NONE,
64	READ = EV_READ,
65	WRITE = EV_WRITE,
66	#if EV_COMPAT3
67	TIMEOUT = EV_TIMEOUT,
68	#endif
69	TIMER = EV_TIMER,
70	PERIODIC = EV_PERIODIC,
71	SIGNAL = EV_SIGNAL,
72	CHILD = EV_CHILD,
73	STAT = EV_STAT,
74	IDLE = EV_IDLE,
75	CHECK = EV_CHECK,
76	PREPARE = EV_PREPARE,
77	FORK = EV_FORK,
78	ASYNC = EV_ASYNC,
79	EMBED = EV_EMBED,
80	# undef ERROR // some systems stupidly #define ERROR
81	ERROR = EV_ERROR
82	};
83
84	enum
85	{
86	AUTO = EVFLAG_AUTO,
87	NOENV = EVFLAG_NOENV,
88	FORKCHECK = EVFLAG_FORKCHECK,
89
90	SELECT = EVBACKEND_SELECT,
91	POLL = EVBACKEND_POLL,
92	EPOLL = EVBACKEND_EPOLL,
93	KQUEUE = EVBACKEND_KQUEUE,
94	DEVPOLL = EVBACKEND_DEVPOLL,
95	PORT = EVBACKEND_PORT
96	};
97
98	enum
99	{
100	#if EV_COMPAT3
101	NONBLOCK = EVLOOP_NONBLOCK,
102	ONESHOT = EVLOOP_ONESHOT,
103	#endif
104	NOWAIT = EVRUN_NOWAIT,
105	ONCE = EVRUN_ONCE
106	};
107
108	enum how_t
109	{
110	ONE = EVBREAK_ONE,
111	ALL = EVBREAK_ALL
112	};
113
114	struct bad_loop
115	#if EV_USE_STDEXCEPT
116	: std::exception
117	#endif
118	{
119	#if EV_USE_STDEXCEPT
120	const char *what () const EV_NOEXCEPT
121	{
122	return "libev event loop cannot be initialized, bad value of LIBEV_FLAGS?";
123	}
124	#endif
125	};
126
127	#ifdef EV_AX
128	# undef EV_AX
129	#endif
130
131	#ifdef EV_AX_
132	# undef EV_AX_
133	#endif
134
135	#if EV_MULTIPLICITY
136	# define EV_AX raw_loop
137	# define EV_AX_ raw_loop,
138	#else
139	# define EV_AX
140	# define EV_AX_
141	#endif
142
143	struct loop_ref
144	{
145	loop_ref (EV_P) EV_NOEXCEPT
146	#if EV_MULTIPLICITY
147	: EV_AX (EV_A)
148	#endif
149	{
150	}
151
152	bool operator == (const loop_ref &other) const EV_NOEXCEPT
153	{
154	#if EV_MULTIPLICITY
155	return EV_AX == other.EV_AX;
156	#else
157	return true;
158	#endif
159	}
160
161	bool operator != (const loop_ref &other) const EV_NOEXCEPT
162	{
163	#if EV_MULTIPLICITY
164	return ! (*this == other);
165	#else
166	return false;
167	#endif
168	}
169
170	#if EV_MULTIPLICITY
171	bool operator == (const EV_P) const EV_NOEXCEPT
172	{
173	return this->EV_AX == EV_A;
174	}
175
176	bool operator != (const EV_P) const EV_NOEXCEPT
177	{
178	return ! (*this == EV_A);
179	}
180
181	operator struct ev_loop * () const EV_NOEXCEPT
182	{
183	return EV_AX;
184	}
185
186	operator const struct ev_loop * () const EV_NOEXCEPT
187	{
188	return EV_AX;
189	}
190
191	bool is_default () const EV_NOEXCEPT
192	{
193	return EV_AX == ev_default_loop (0);
194	}
195	#endif
196
197	#if EV_COMPAT3
198	void loop (int flags = 0)
199	{
200	ev_run (EV_AX_ flags);
201	}
202
203	void unloop (how_t how = ONE) EV_NOEXCEPT
204	{
205	ev_break (EV_AX_ how);
206	}
207	#endif
208
209	void run (int flags = 0)
210	{
211	ev_run (EV_AX_ flags);
212	}
213
214	void break_loop (how_t how = ONE) EV_NOEXCEPT
215	{
216	ev_break (EV_AX_ how);
217	}
218
219	void post_fork () EV_NOEXCEPT
220	{
221	ev_loop_fork (EV_AX);
222	}
223
224	unsigned int backend () const EV_NOEXCEPT
225	{
226	return ev_backend (EV_AX);
227	}
228
229	tstamp now () const EV_NOEXCEPT
230	{
231	return ev_now (EV_AX);
232	}
233
234	void ref () EV_NOEXCEPT
235	{
236	ev_ref (EV_AX);
237	}
238
239	void unref () EV_NOEXCEPT
240	{
241	ev_unref (EV_AX);
242	}
243
244	#if EV_FEATURE_API
245	unsigned int iteration () const EV_NOEXCEPT
246	{
247	return ev_iteration (EV_AX);
248	}
249
250	unsigned int depth () const EV_NOEXCEPT
251	{
252	return ev_depth (EV_AX);
253	}
254
255	void set_io_collect_interval (tstamp interval) EV_NOEXCEPT
256	{
257	ev_set_io_collect_interval (EV_AX_ interval);
258	}
259
260	void set_timeout_collect_interval (tstamp interval) EV_NOEXCEPT
261	{
262	ev_set_timeout_collect_interval (EV_AX_ interval);
263	}
264	#endif
265
266	// function callback
267	void once (int fd, int events, tstamp timeout, void (cb)(int, void ), void *arg = 0) EV_NOEXCEPT
268	{
269	ev_once (EV_AX_ fd, events, timeout, cb, arg);
270	}
271
272	// method callback
273	template<class K, void (K::*method)(int)>
274	void once (int fd, int events, tstamp timeout, K *object) EV_NOEXCEPT
275	{
276	once (fd, events, timeout, method_thunk<K, method>, object);
277	}
278
279	// default method == operator ()
280	template<class K>
281	void once (int fd, int events, tstamp timeout, K *object) EV_NOEXCEPT
282	{
283	once (fd, events, timeout, method_thunk<K, &K::operator ()>, object);
284	}
285
286	template<class K, void (K::*method)(int)>
287	static void method_thunk (int revents, void *arg)
288	{
289	(static_cast<K >(arg)->method)
290	(revents);
291	}
292
293	// no-argument method callback
294	template<class K, void (K::*method)()>
295	void once (int fd, int events, tstamp timeout, K *object) EV_NOEXCEPT
296	{
297	once (fd, events, timeout, method_noargs_thunk<K, method>, object);
298	}
299
300	template<class K, void (K::*method)()>
301	static void method_noargs_thunk (int revents, void *arg)
302	{
303	(static_cast<K >(arg)->method)
304	();
305	}
306
307	// simpler function callback
308	template<void (*cb)(int)>
309	void once (int fd, int events, tstamp timeout) EV_NOEXCEPT
310	{
311	once (fd, events, timeout, simpler_func_thunk<cb>);
312	}
313
314	template<void (*cb)(int)>
315	static void simpler_func_thunk (int revents, void *arg)
316	{
317	(*cb)
318	(revents);
319	}
320
321	// simplest function callback
322	template<void (*cb)()>
323	void once (int fd, int events, tstamp timeout) EV_NOEXCEPT
324	{
325	once (fd, events, timeout, simplest_func_thunk<cb>);
326	}
327
328	template<void (*cb)()>
329	static void simplest_func_thunk (int revents, void *arg)
330	{
331	(*cb)
332	();
333	}
334
335	void feed_fd_event (int fd, int revents) EV_NOEXCEPT
336	{
337	ev_feed_fd_event (EV_AX_ fd, revents);
338	}
339
340	void feed_signal_event (int signum) EV_NOEXCEPT
341	{
342	ev_feed_signal_event (EV_AX_ signum);
343	}
344
345	#if EV_MULTIPLICITY
346	struct ev_loop* EV_AX;
347	#endif
348
349	};
350
351	#if EV_MULTIPLICITY
352	struct dynamic_loop : loop_ref
353	{
354
355	dynamic_loop (unsigned int flags = AUTO)
356	: loop_ref (ev_loop_new (flags))
357	{
358	if (!EV_AX)
359	throw bad_loop ();
360	}
361
362	~dynamic_loop () EV_NOEXCEPT
363	{
364	ev_loop_destroy (EV_AX);
365	EV_AX = 0;
366	}
367
368	private:
369
370	dynamic_loop (const dynamic_loop &);
371
372	dynamic_loop & operator= (const dynamic_loop &);
373
374	};
375	#endif
376
377	struct default_loop : loop_ref
378	{
379	default_loop (unsigned int flags = AUTO)
380	#if EV_MULTIPLICITY
381	: loop_ref (ev_default_loop (flags))
382	#endif
383	{
384	if (
385	#if EV_MULTIPLICITY
386	!EV_AX
387	#else
388	!ev_default_loop (flags)
389	#endif
390	)
391	throw bad_loop ();
392	}
393
394	private:
395	default_loop (const default_loop &);
396	default_loop &operator = (const default_loop &);
397	};
398
399	inline loop_ref get_default_loop () EV_NOEXCEPT
400	{
401	#if EV_MULTIPLICITY
402	return ev_default_loop (0);
403	#else
404	return loop_ref ();
405	#endif
406	}
407
408	#undef EV_AX
409	#undef EV_AX_
410
411	#undef EV_PX
412	#undef EV_PX_
413	#if EV_MULTIPLICITY
414	# define EV_PX loop_ref EV_A
415	# define EV_PX_ loop_ref EV_A_
416	#else
417	# define EV_PX
418	# define EV_PX_
419	#endif
420
421	template<class ev_watcher, class watcher>
422	struct base : ev_watcher
423	{
424	// scoped pause/unpause of a watcher
425	struct freeze_guard
426	{
427	watcher &w;
428	bool active;
429
430	freeze_guard (watcher *self) EV_NOEXCEPT
431	: w (*self), active (w.is_active ())
432	{
433	if (active) w.stop ();
434	}
435
436	~freeze_guard ()
437	{
438	if (active) w.start ();
439	}
440	};
441
442	#if EV_MULTIPLICITY
443	EV_PX;
444
445	// loop set
446	void set (EV_P) EV_NOEXCEPT
447	{
448	this->EV_A = EV_A;
449	}
450	#endif
451
452	base (EV_PX) EV_NOEXCEPT
453	#if EV_MULTIPLICITY
454	: EV_A (EV_A)
455	#endif
456	{
457	ev_init (this, 0);
458	}
459
460	void set_ (const void data, void (cb)(EV_P_ ev_watcher *w, int revents)) EV_NOEXCEPT
461	{
462	this->data = (void *)data;
463	ev_set_cb (static_cast<ev_watcher *>(this), cb);
464	}
465
466	// function callback
467	template<void (*function)(watcher &w, int)>
468	void set (void *data = 0) EV_NOEXCEPT
469	{
470	set_ (data, function_thunk<function>);
471	}
472
473	template<void (*function)(watcher &w, int)>
474	static void function_thunk (EV_P_ ev_watcher *w, int revents)
475	{
476	function
477	(static_cast<watcher >(w), revents);
478	}
479
480	// method callback
481	template<class K, void (K::*method)(watcher &w, int)>
482	void set (K *object) EV_NOEXCEPT
483	{
484	set_ (object, method_thunk<K, method>);
485	}
486
487	// default method == operator ()
488	template<class K>
489	void set (K *object) EV_NOEXCEPT
490	{
491	set_ (object, method_thunk<K, &K::operator ()>);
492	}
493
494	template<class K, void (K::*method)(watcher &w, int)>
495	static void method_thunk (EV_P_ ev_watcher *w, int revents)
496	{
497	(static_cast<K >(w->data)->method)
498	(static_cast<watcher >(w), revents);
499	}
500
501	// no-argument callback
502	template<class K, void (K::*method)()>
503	void set (K *object) EV_NOEXCEPT
504	{
505	set_ (object, method_noargs_thunk<K, method>);
506	}
507
508	template<class K, void (K::*method)()>
509	static void method_noargs_thunk (EV_P_ ev_watcher *w, int revents)
510	{
511	(static_cast<K >(w->data)->method)
512	();
513	}
514
515	void operator ()(int events = EV_UNDEF)
516	{
517	return
518	ev_cb (static_cast<ev_watcher *>(this))
519	(static_cast<ev_watcher *>(this), events);
520	}
521
522	bool is_active () const EV_NOEXCEPT
523	{
524	return ev_is_active (static_cast<const ev_watcher *>(this));
525	}
526
527	bool is_pending () const EV_NOEXCEPT
528	{
529	return ev_is_pending (static_cast<const ev_watcher *>(this));
530	}
531
532	void feed_event (int revents) EV_NOEXCEPT
533	{
534	ev_feed_event (EV_A_ static_cast<ev_watcher *>(this), revents);
535	}
536	};
537
538	inline tstamp now (EV_P) EV_NOEXCEPT
539	{
540	return ev_now (EV_A);
541	}
542
543	inline void delay (tstamp interval) EV_NOEXCEPT
544	{
545	ev_sleep (interval);
546	}
547
548	inline int version_major () EV_NOEXCEPT
549	{
550	return ev_version_major ();
551	}
552
553	inline int version_minor () EV_NOEXCEPT
554	{
555	return ev_version_minor ();
556	}
557
558	inline unsigned int supported_backends () EV_NOEXCEPT
559	{
560	return ev_supported_backends ();
561	}
562
563	inline unsigned int recommended_backends () EV_NOEXCEPT
564	{
565	return ev_recommended_backends ();
566	}
567
568	inline unsigned int embeddable_backends () EV_NOEXCEPT
569	{
570	return ev_embeddable_backends ();
571	}
572
573	inline void set_allocator (void (cb)(void *ptr, long size) EV_NOEXCEPT) EV_NOEXCEPT
574	{
575	ev_set_allocator (cb);
576	}
577
578	inline void set_syserr_cb (void (cb)(const char msg) EV_NOEXCEPT) EV_NOEXCEPT
579	{
580	ev_set_syserr_cb (cb);
581	}
582
583	#if EV_MULTIPLICITY
584	#define EV_CONSTRUCT(cppstem,cstem) \
585	(EV_PX = get_default_loop ()) EV_NOEXCEPT \
586	: base<ev_ ## cstem, cppstem> (EV_A) \
587	{ \
588	}
589	#else
590	#define EV_CONSTRUCT(cppstem,cstem) \
591	() EV_NOEXCEPT \
592	{ \
593	}
594	#endif
595
596	/* using a template here would require quite a few more lines,
597	* so a macro solution was chosen */
598	#define EV_BEGIN_WATCHER(cppstem,cstem) \
599	\
600	struct cppstem : base<ev_ ## cstem, cppstem> \
601	{ \
602	void start () EV_NOEXCEPT \
603	{ \
604	ev_ ## cstem ## _start (EV_A_ static_cast<ev_ ## cstem *>(this)); \
605	} \
606	\
607	void stop () EV_NOEXCEPT \
608	{ \
609	ev_ ## cstem ## _stop (EV_A_ static_cast<ev_ ## cstem *>(this)); \
610	} \
611	\
612	cppstem EV_CONSTRUCT(cppstem,cstem) \
613	\
614	~cppstem () EV_NOEXCEPT \
615	{ \
616	stop (); \
617	} \
618	\
619	using base<ev_ ## cstem, cppstem>::set; \
620	\
621	private: \
622	\
623	cppstem (const cppstem &o); \
624	\
625	cppstem &operator =(const cppstem &o); \
626	\
627	public:
628
629	#define EV_END_WATCHER(cppstem,cstem) \
630	};
631	//TODO: https://paste.debian.net/1268417/
632
633	EV_BEGIN_WATCHER (io, io)
634	void set (int fd, int events) EV_NOEXCEPT
635	{
636	freeze_guard freeze (this);
637	ev_io_set (static_cast<ev_io *>(this), fd, events);
638	}
639
640	void set (int events) EV_NOEXCEPT
641	{
642	freeze_guard freeze (this);
643	ev_io_modify (static_cast<ev_io *>(this), events);
644	}
645
646	void start (int fd, int events) EV_NOEXCEPT
647	{
648	set (fd, events);
649	start ();
650	}
651	EV_END_WATCHER (io, io)
652
653	EV_BEGIN_WATCHER (timer, timer)
654	void set (ev_tstamp after, ev_tstamp repeat = 0.) EV_NOEXCEPT
655	{
656	freeze_guard freeze (this);
657	ev_timer_set (static_cast<ev_timer *>(this), after, repeat);
658	}
659
660	void start (ev_tstamp after, ev_tstamp repeat = 0.) EV_NOEXCEPT
661	{
662	set (after, repeat);
663	start ();
664	}
665
666	void again () EV_NOEXCEPT
667	{
668	ev_timer_again (EV_A_ static_cast<ev_timer *>(this));
669	}
670
671	ev_tstamp remaining ()
672	{
673	return ev_timer_remaining (EV_A_ static_cast<ev_timer *>(this));
674	}
675	EV_END_WATCHER (timer, timer)
676
677	#if EV_PERIODIC_ENABLE
678	EV_BEGIN_WATCHER (periodic, periodic)
679	void set (ev_tstamp at, ev_tstamp interval = 0.) EV_NOEXCEPT
680	{
681	freeze_guard freeze (this);
682	ev_periodic_set (static_cast<ev_periodic *>(this), at, interval, 0);
683	}
684
685	void start (ev_tstamp at, ev_tstamp interval = 0.) EV_NOEXCEPT
686	{
687	set (at, interval);
688	start ();
689	}
690
691	void again () EV_NOEXCEPT
692	{
693	ev_periodic_again (EV_A_ static_cast<ev_periodic *>(this));
694	}
695	EV_END_WATCHER (periodic, periodic)
696	#endif
697
698	#if EV_SIGNAL_ENABLE
699	EV_BEGIN_WATCHER (sig, signal)
700	void set (int signum) EV_NOEXCEPT
701	{
702	freeze_guard freeze (this);
703	ev_signal_set (static_cast<ev_signal *>(this), signum);
704	}
705
706	void start (int signum) EV_NOEXCEPT
707	{
708	set (signum);
709	start ();
710	}
711	EV_END_WATCHER (sig, signal)
712	#endif
713
714	#if EV_CHILD_ENABLE
715	EV_BEGIN_WATCHER (child, child)
716	void set (int pid, int trace = 0) EV_NOEXCEPT
717	{
718	freeze_guard freeze (this);
719	ev_child_set (static_cast<ev_child *>(this), pid, trace);
720	}
721
722	void start (int pid, int trace = 0) EV_NOEXCEPT
723	{
724	set (pid, trace);
725	start ();
726	}
727	EV_END_WATCHER (child, child)
728	#endif
729
730	#if EV_STAT_ENABLE
731	EV_BEGIN_WATCHER (stat, stat)
732	void set (const char *path, ev_tstamp interval = 0.) EV_NOEXCEPT
733	{
734	freeze_guard freeze (this);
735	ev_stat_set (static_cast<ev_stat *>(this), path, interval);
736	}
737
738	void start (const char *path, ev_tstamp interval = 0.) EV_NOEXCEPT
739	{
740	stop ();
741	set (path, interval);
742	start ();
743	}
744
745	void update () EV_NOEXCEPT
746	{
747	ev_stat_stat (EV_A_ static_cast<ev_stat *>(this));
748	}
749	EV_END_WATCHER (stat, stat)
750	#endif
751
752	#if EV_IDLE_ENABLE
753	EV_BEGIN_WATCHER (idle, idle)
754	void set () EV_NOEXCEPT { }
755	EV_END_WATCHER (idle, idle)
756	#endif
757
758	#if EV_PREPARE_ENABLE
759	EV_BEGIN_WATCHER (prepare, prepare)
760	void set () EV_NOEXCEPT { }
761	EV_END_WATCHER (prepare, prepare)
762	#endif
763
764	#if EV_CHECK_ENABLE
765	EV_BEGIN_WATCHER (check, check)
766	void set () EV_NOEXCEPT { }
767	EV_END_WATCHER (check, check)
768	#endif
769
770	#if EV_EMBED_ENABLE
771	EV_BEGIN_WATCHER (embed, embed)
772	void set_embed (struct ev_loop *embedded_loop) EV_NOEXCEPT
773	{
774	freeze_guard freeze (this);
775	ev_embed_set (static_cast<ev_embed *>(this), embedded_loop);
776	}
777
778	void start (struct ev_loop *embedded_loop) EV_NOEXCEPT
779	{
780	set (embedded_loop);
781	start ();
782	}
783
784	void sweep ()
785	{
786	ev_embed_sweep (EV_A_ static_cast<ev_embed *>(this));
787	}
788	EV_END_WATCHER (embed, embed)
789	#endif
790
791	#if EV_FORK_ENABLE
792	EV_BEGIN_WATCHER (fork, fork)
793	void set () EV_NOEXCEPT { }
794	EV_END_WATCHER (fork, fork)
795	#endif
796
797	#if EV_ASYNC_ENABLE
798	EV_BEGIN_WATCHER (async, async)
799	void send () EV_NOEXCEPT
800	{
801	ev_async_send (EV_A_ static_cast<ev_async *>(this));
802	}
803
804	bool async_pending () EV_NOEXCEPT
805	{
806	return ev_async_pending (static_cast<ev_async *>(this));
807	}
808	EV_END_WATCHER (async, async)
809	#endif
810
811	#undef EV_PX
812	#undef EV_PX_
813	#undef EV_CONSTRUCT
814	#undef EV_BEGIN_WATCHER
815	#undef EV_END_WATCHER
816	}
817
818	#endif
819