/** \file IEventHandler.h
 ** \date  2005-12-07
 ** \author grymse@alhem.net
**/
/*
Copyright (C) 2005-2010  Anders Hedstrom

This library is made available under the terms of the GNU GPL, with
the additional exemption that compiling, linking, and/or using OpenSSL
is allowed.

If you would like to use this library in a closed-source application,
a separate license agreement is available. For information about
the closed-source license agreement for the C++ sockets library,
please visit http://www.alhem.net/Sockets/license.html and/or
email license@alhem.net.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
*/
#ifndef _SOCKETS_IEventHandler_H
#define _SOCKETS_IEventHandler_H

#include "sockets-config.h"

#ifdef SOCKETS_NAMESPACE
namespace SOCKETS_NAMESPACE
{
#endif


class IEventOwner;

/** Timer event handler pure virtual base class.
  \ingroup timer */
class IEventHandler
{
public:
  virtual ~IEventHandler() {}

  /** Return time left until next event.
    \param tv Time struct that will be filled by method
    \return true if time is set for next event */
  virtual bool GetTimeUntilNextEvent(struct timeval *) = 0;
  /** Will fire events whose time has come. */
  virtual void CheckEvents() = 0;
  /** Schedule event for an owner.
    \param from Event owner
    \param sec Seconds until event
    \param usec Microseconds until event */
  virtual long AddEvent(IEventOwner *,long sec,long usec) = 0;
  /** Clear all events for a specific owner. */
  virtual void ClearEvents(IEventOwner *) = 0;
  /** Remove one specific event for an event owner. */
  virtual void RemoveEvent(IEventOwner *,long) = 0;

};




#ifdef SOCKETS_NAMESPACE
}
#endif

#endif // _SOCKETS_IEventHandler_H

