Thread.h++

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
   commonc++ - A C++ Common Class Library
   Copyright (C) 2005-2014  Mark A Lindner

   This file is part of commonc++.

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

   This library 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
   Library General Public License for more details.

   You should have received a copy of the GNU Library General Public
   License along with this library; if not, write to the Free
   Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
   ---------------------------------------------------------------------------
*/

#ifndef __ccxx_Thread_hxx
#define __ccxx_Thread_hxx

#include <commonc++/Common.h++>
#include <commonc++/AtomicCounter.h++>
#include <commonc++/Runnable.h++>
#include <commonc++/ThreadLocal.h++>
#include <commonc++/String.h++>

#ifdef CCXX_OS_POSIX
#include <pthread.h>
#endif

namespace ccxx {

class COMMONCPP_API Thread : public Runnable
{
 public:

  Thread(bool detached = false, size_t stackSize = 0);

  Thread(Runnable* runnable, bool detached = false, size_t stackSize = 0);

  virtual ~Thread();

  virtual void start();

  virtual void stop();

  bool join();

  bool isRunning() const;

  inline bool isDetached() const
  { return(_detached); }

  void setPriority(Priority priority);

  Priority getPriority() const;

  inline void setName(const String& name)
  { _name = name; }

  inline String getName() const
  { return(_name); }

  static void sleep(timespan_ms_t msec);

  static Thread* currentThread();

  static ThreadID currentThreadID();

 protected:

  virtual void run();

  virtual void cleanup();

  bool trySleep(timespan_ms_t msec);

  bool testCancel();

  void yield();

  static void exit();

 private:

  Thread(ThreadHandle id);

  AtomicCounter _runFlag;
  bool _cancelled;
  bool _detached;
  size_t _stackSize;
  String _name;
#ifdef CCXX_OS_WINDOWS
  HANDLE _thread;
  HANDLE _cancelEvent;
  bool _cleanupDone;
#else
  pthread_t _thread;
  pthread_attr_t _attrs;
#endif
  Runnable* _runnable;

#ifdef CCXX_OS_WINDOWS
  static DWORD WINAPI _startupDispatcher(LPVOID arg);
  static void _cleanupTLS();
#else
  static void* _startupDispatcher(void* arg);
  static void _cleanupDispatcher(void* arg);
#endif

  void _run();
  void _init();

  CCXX_COPY_DECLS(Thread);
};

} // namespace ccxx

#endif // __ccxx_Thread_hxx