Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext

Class interprocess_condition

boost::interprocess::interprocess_condition

Synopsis

// In header: <boost/interprocess/sync/interprocess_condition.hpp>


class interprocess_condition {
public:
  // construct/copy/destruct
  ();
  ~();

  // public member functions
   ();
   ();
  template<typename L>  ();
  template<typename L, typename Pr>  (, );
  template<typename L, typename TimePoint> 
     (, );
  template<typename L, typename TimePoint, typename Pr> 
     (, , );
  template<typename L, typename TimePoint> 
     (, );
  template<typename L, typename TimePoint, typename Pr> 
     (, , );
  template<typename L, typename Duration> 
     (, );
  template<typename L, typename Duration, typename Pr> 
     (, , );
};

Description

This class is a condition variable that can be placed in shared memory or memory mapped files. Destroys the object of type std::condition_variable_any

Unlike std::condition_variable in C++11, it is NOT safe to invoke the destructor if all threads have been only notified. It is required that they have exited their respective wait functions.

interprocess_condition public construct/copy/destruct

  1. ();
    Constructs a interprocess_condition. On error throws interprocess_exception.
  2. ~();

    Destroys *this liberating system resources.

interprocess_condition public member functions

  1.  ();

    If there is a thread waiting on *this, change that thread's state to ready. Otherwise there is no effect.

  2.  ();

    Change the state of all threads waiting on *this to ready. If there are no waiting threads, notify_all() has no effect.

  3. template<typename L>  ( lock);

    Releases the lock on the interprocess_mutex object associated with lock, blocks the current thread of execution until readied by a call to this->notify_one() or this->notify_all(), and then reacquires the lock.

  4. template<typename L, typename Pr>  ( lock,  pred);

    The same as: while (!pred()) wait(lock)

  5. template<typename L, typename TimePoint> 
       ( lock,  abs_time);

    Releases the lock on the interprocess_mutex object associated with lock, blocks the current thread of execution until readied by a call to this->notify_one() or this->notify_all(), or until time abs_time is reached, and then reacquires the lock. Returns: false if time abs_time is reached, otherwise true.

  6. template<typename L, typename TimePoint, typename Pr> 
       ( lock,  abs_time,  pred);

    The same as: while (!pred()) { if (!timed_wait(lock, abs_time)) return pred(); } return true;

  7. template<typename L, typename TimePoint> 
       ( lock,  abs_time);

    Same as timed_wait, but this function is modeled after the standard library interface.

  8. template<typename L, typename TimePoint, typename Pr> 
       ( lock,  abs_time,  pred);

    Same as timed_wait, but this function is modeled after the standard library interface.

  9. template<typename L, typename Duration> 
       ( lock,  dur);

    Same as timed_wait, but this function is modeled after the standard library interface and uses relative timeouts.

  10. template<typename L, typename Duration, typename Pr> 
       ( lock,  dur,  pred);

    Same as timed_wait, but this function is modeled after the standard library interface and uses relative timeouts


PrevUpHomeNext