ACE/ace/Manual_Event.h

   1 // -*- C++ -*-
   2
   3 //==========================================================================
   4 /**
   5  *  @file    Manual_Event.h
   6  *
   7  *  @author Douglas C. Schmidt <d.schmidt@vanderbilt.edu>
   8  */
   9 //==========================================================================
  10
  11 #ifndef ACE_MANUAL_EVENT_H
  12 #define ACE_MANUAL_EVENT_H
  13 #include /**/ "ace/pre.h"
  14
  15 #include /**/ "ace/ACE_export.h"
  16
  17 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  18 # pragma once
  19 #endif /* ACE_LACKS_PRAGMA_ONCE */
  20
  21 #include "ace/Event.h"
  22
  23 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  24
  25 /**
  26  * @class ACE_Manual_Event
  27  *
  28  * @brief Manual Events.
  29  *
  30  * Specialization of Event mechanism which wakes up all waiting
  31  * thread on <signal>.  All platforms support process-scope locking
  32  * support.  However, only Win32 platforms support global naming and
  33  * system-scope locking support.
  34  */
  35 template <class TIME_POLICY = ACE_System_Time_Policy>
  36 class ACE_Manual_Event_T : public ACE_Event_T<TIME_POLICY>
  37 {
  38 public:
  39   /// Constructor which will create manual event
  40   ACE_Manual_Event_T (int initial_state = 0,
  41                       int type = USYNC_THREAD,
  42                       const char *name = 0,
  43                       void *arg = 0);
  44
  45 #if defined (ACE_HAS_WCHAR)
  46   /// Constructor which will create manual event (wchar_t version)
  47   ACE_Manual_Event_T (int initial_state,
  48                       int type,
  49                       const wchar_t *name,
  50                       void *arg = 0);
  51 #endif /* ACE_HAS_WCHAR */
  52
  53   /// Default dtor.
  54   ~ACE_Manual_Event_T () = default;
  55
  56   /// Dump the state of an object.
  57   void dump () const;
  58
  59   /// Declare the dynamic allocation hooks
  60   ACE_ALLOC_HOOK_DECLARE;
  61 };
  62
  63 class ACE_Manual_Event :
  64   public ACE_Manual_Event_T<ACE_System_Time_Policy>
  65 {
  66 public:
  67   /// Constructor which will create auto event
  68   ACE_Manual_Event (int initial_state = 0,
  69                     int type = USYNC_THREAD,
  70                     const char *name = 0,
  71                     void *arg = 0)
  72   : ACE_Manual_Event_T<ACE_System_Time_Policy> (initial_state, type, name, arg)
  73   {}
  74
  75 #if defined (ACE_HAS_WCHAR)
  76   /// Constructor which will create auto event (wchar_t version)
  77   ACE_Manual_Event (int initial_state,
  78                     int type,
  79                     const wchar_t *name,
  80                     void *arg = 0)
  81   : ACE_Manual_Event_T<ACE_System_Time_Policy> (initial_state, type, name, arg)
  82   {}
  83 #endif /* ACE_HAS_WCHAR */
  84
  85   /// Default dtor.
  86   ~ACE_Manual_Event () override = default;
  87 };
  88
  89 ACE_END_VERSIONED_NAMESPACE_DECL
  90
  91 #include "ace/Manual_Event.cpp"
  92
  93 #include /**/ "ace/post.h"
  94 #endif /* ACE_MANUAL_EVENT_H */