src/lib/platform/threads/threads.h

   1 #pragma once
   2 /*
   3  * This file is part of the libCEC(R) library.
   4  *
   5  * libCEC(R) is Copyright (C) 2011 Pulse-Eight Limited.  All rights reserved.
   6  * libCEC(R) is an original work, containing original code.
   7  *
   8  * libCEC(R) is a trademark of Pulse-Eight Limited.
   9  *
  10  * This program is dual-licensed; you can redistribute it and/or modify
  11  * it under the terms of the GNU General Public License as published by
  12  * the Free Software Foundation; either version 2 of the License, or
  13  * (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  23  *
  24  *
  25  * Alternatively, you can license this library under a commercial license,
  26  * please contact Pulse-Eight Licensing for more information.
  27  *
  28  * For more information contact:
  29  * Pulse-Eight Licensing       <license@pulse-eight.com>
  30  *     http://www.pulse-eight.com/
  31  *     http://www.pulse-eight.net/
  32  */
  33
  34 #include "mutex.h"
  35
  36 namespace PLATFORM
  37 {
  38   class CThread
  39   {
  40   public:
  41     CThread(void) :
  42         m_bStop(false),
  43         m_bRunning(false) {}
  44
  45     virtual ~CThread(void)
  46     {
  47       StopThread();
  48     }
  49
  50     static void *ThreadHandler(CThread *thread)
  51     {
  52       void *retVal = NULL;
  53
  54       if (thread)
  55       {
  56         CLockObject lock(thread->m_threadMutex);
  57         thread->m_bRunning = true;
  58         lock.Unlock();
  59         thread->m_threadCondition.Broadcast();
  60
  61         retVal = thread->Process();
  62
  63         lock.Lock();
  64         thread->m_bRunning = false;
  65         lock.Unlock();
  66         thread->m_threadCondition.Broadcast();
  67       }
  68
  69       return retVal;
  70     }
  71
  72     inline bool IsRunning(void)
  73     {
  74       CLockObject lock(m_threadMutex);
  75       return m_bRunning;
  76     }
  77
  78     inline bool IsStopped(void)
  79     {
  80       CLockObject lock(m_threadMutex);
  81       return m_bStop;
  82     }
  83
  84     inline bool CreateThread(bool bWait = true)
  85     {
  86         bool bReturn(false);
  87         CLockObject lock(m_threadMutex);
  88         if (!IsRunning())
  89         {
  90           if (ThreadsCreate(m_thread, CThread::ThreadHandler, ((void*)static_cast<CThread *>(this))))
  91           {
  92             if (bWait)
  93               m_threadCondition.Wait(m_threadMutex);
  94             bReturn = true;
  95           }
  96         }
  97       return bReturn;
  98     }
  99
 100     inline bool StopThread(bool bWaitForExit = true)
 101     {
 102       bool bReturn(true);
 103       bool bRunning(false);
 104       {
 105         CLockObject lock(m_threadMutex);
 106         bRunning = IsRunning();
 107         m_bStop = true;
 108         m_threadCondition.Broadcast();
 109       }
 110
 111       if (bRunning && bWaitForExit)
 112       {
 113         void *retVal = NULL;
 114         bReturn = ThreadsWait(m_thread, &retVal);
 115       }
 116       return true;
 117     }
 118
 119     inline bool Sleep(uint32_t iTimeout)
 120     {
 121       CLockObject lock(m_threadMutex);
 122       return m_bStop ? false : m_threadCondition.Wait(m_threadMutex, iTimeout);
 123     }
 124
 125     virtual void *Process(void) = 0;
 126
 127   protected:
 128     void SetRunning(bool bSetTo);
 129
 130   private:
 131     bool       m_bStop;
 132     bool       m_bRunning;
 133     CCondition m_threadCondition;
 134     CMutex     m_threadMutex;
 135     thread_t   m_thread;
 136   };
 137 };