ArThread.h

/*
ActivMedia Robotics Interface for Applications (ARIA)
Copyright (C) 2004,2005 ActivMedia Robotics, LLC


     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

If you wish to redistribute ARIA under different terms, contact 
ActivMedia Robotics for information about a commercial version of ARIA at 
robots@activmedia.com or 
ActivMedia Robotics, 19 Columbia Drive, Amherst, NH 03031; 800-639-9481

*/

#ifndef ARTHREAD_H
#define ARTHREAD_H


#include <map>
#ifndef WIN32
#include <pthread.h>
#endif
#include "ariaTypedefs.h"
#include "ArMutex.h"
#include "ArFunctor.h"
#include "ArLog.h"


class ArThread
{
public:

#ifdef WIN32
  typedef HANDLE ThreadType;
#else
  typedef pthread_t ThreadType;
#endif

  typedef std::map<ThreadType, ArThread*> MapType;
  typedef enum {
    STATUS_FAILED=1, 
    STATUS_NORESOURCE, 
    STATUS_NO_SUCH_THREAD, 
    STATUS_INVALID, 
    STATUS_JOIN_SELF, 
    STATUS_ALREADY_DETATCHED 
  } Status;

  ArThread(bool blockAllSignals=true);
  ArThread(ThreadType thread, bool joinable,
                    bool blockAllSignals=true);
  ArThread(ArFunctor *func, bool joinable=true,
                    bool blockAllSignals=true);
  virtual ~ArThread();

  static void init(void);
  static ArThread * self(void);
  static void stopAll();
  static void cancelAll(void);
  static void joinAll(void);
  static void yieldProcessor(void);
  static ArLog::LogLevel getLogLevel(void) { return ourLogLevel; }
  static void setLogLevel(ArLog::LogLevel level) { ourLogLevel = level; }

  virtual int create(ArFunctor *func, bool joinable=true,
                              bool lowerPriority=true);
  virtual void stopRunning(void) {myRunning=false;}
  virtual int join(void **ret=NULL);
  virtual int detach(void);
  virtual void cancel(void);

  virtual bool getRunning(void) const {return(myRunning);}
  virtual bool getRunningWithLock(void) 
    { bool running; lock(); running = myRunning; unlock(); return running; }
  virtual bool getJoinable(void) const {return(myJoinable);}
  virtual const ThreadType * getThread(void) const {return(&myThread);}
  virtual ArFunctor * getFunc(void) const {return(myFunc);}

  virtual void setRunning(bool running) {myRunning=running;}

  int lock(void) {return(myMutex.lock());}
  int tryLock(void) {return(myMutex.tryLock());}
  int unlock(void) {return(myMutex.unlock());}

  bool getBlockAllSignals(void) {return(myBlockAllSignals);}

  virtual const char *getThreadName(void) { return myName.c_str();  }

  virtual void setThreadName(const char *name) { myName = name; }


  virtual void threadStarted(void);

  virtual void logThreadInfo(void);

protected:
  static ArMutex ourThreadsMutex;
  static MapType ourThreads;
  static ArLog::LogLevel ourLogLevel;

  virtual int doJoin(void **ret=NULL);

  std::string myName;

  ArMutex myMutex;
  bool myRunning;
  bool myJoinable;
  bool myBlockAllSignals;
  ArFunctor *myFunc;
  ThreadType myThread;
  ArStrMap myStrMap;

#ifndef WIN32
  pid_t myPID;
#endif

};


#endif // ARTHREAD_H

---