class ThreadCondition

Public Methods

•  ThreadCondition ()
• virtual  ~ThreadCondition ()
• inline void  wakeOne ()
• inline void  wakeAll ()
• inline void  wait (Mutex& mutex)

Detailed Description

A thread condition

Thread conditions are used to let a different thread know that a certain condition might have changed. For instance, if you have a thread that waits until a counter exceeds a limit, the thread would look like this:

 class WaitCounter : public Arts::Thread 
 {
   int counter;
   Arts::Mutex mutex;
   Arts::ThreadCondition cond;
 
 public:
   WaitCounter() : counter(0) {}

   void run() {  // run will terminate once the counter reaches 20
     mutex.lock();
     while(counter < 20)
       cond.wait(mutex);
     mutex.unlock();
   }

   void inc() {  // inc will increment the counter and indicate the change
     mutex.lock();
     counter++;
     cond.wakeOne();
     mutex.unlock();
   }
 };

[virtual]

wakes one waiting thread

wakes all waiting threads

Waits until the condition changes. You will need to lock the mutex before calling this. Internally it will unlock the mutex (to let others change the condition), and relock it once the wait succeeds.