Thread.h++

Go to the documentation of this file.

/* ---------------------------------------------------------------------------
   commonc++ - A C++ Common Class Library
   Copyright (C) 2005-2012  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++/String.h++>
#include <commonc++/ThreadLocal.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() throw();

  virtual void start() throw();

  virtual void stop() throw();

  bool join() throw();

  bool isRunning() const throw();

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

  void setPriority(Priority priority) throw();

  Priority getPriority() const throw();

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

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

  static void sleep(timespan_ms_t msec) throw();

  static Thread *currentThread();

  static ThreadID currentThreadID() throw();

  protected:

  virtual void run();

  virtual void cleanup();

  bool trySleep(timespan_ms_t msec) throw();

  bool testCancel() throw();

  void yield() throw();

  static void exit() throw();

  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() throw();
#else
  static void *_startupDispatcher(void *arg);
  static void _cleanupDispatcher(void *arg);
#endif

  void _run() throw();
  void _init() throw();

  CCXX_COPY_DECLS(Thread);
};

}; // namespace ccxx

#endif // __ccxx_Thread_hxx

/* end of header file */