Class named_condition

• boost::interprocess::named_condition

簡介

// In header: <boost/interprocess/sync/named_condition.hpp>class named_condition {
public:// construct/copy/destructnamed_condition(create_only_t, const char *, const permissions & = permissions());named_condition(open_or_create_t, const char *, const permissions & = permissions());named_condition(open_only_t, const char *);~named_condition();// public member functions*void notify_one();void notify_all();template<typename L> void wait(L &);template<typename L, typename Pr> void wait(L &, Pr);template<typename L> bool timed_wait(L &, const boost::posix_time::ptime &);template<typename L, typename Pr> bool timed_wait(L &, const boost::posix_time::ptime &, Pr);// public static functionsstatic bool remove(const char *);
};

Description

• A global condition variable that can be created by name. This condition variable is designed to work with?named_mutex?and can't be placed in shared memory or memory mapped files.
• 一個全局條件變量，可以通過名字來創建。這個條件變量被設計成與named_mutex一起工作，不能放在共享內存或內存映射文件中。

named_condition?public construct/copy/destruct

• named_condition(create_only_t create_only, const char * name, const permissions & perm = permissions());
• Creates a global condition with a name. If the condition can't be created throws?interprocess_exception
• 創建一個帶有名稱的全局條件。如果條件不能被創建，則拋出interprocess_exception。

?

• named_condition(open_or_create_t open_or_create, const char * name,
const permissions & perm = permissions());
• Opens or creates a global condition with a name. If the condition is created, this call is equivalent to named_condition(create_only_t, ... ) If the condition is already created, this call is equivalent named_condition(open_only_t, ... ) Does not throw
• 打開或創建一個帶有名稱的全局條件。如果條件已經創建，這個調用相當于 named_condition(create_only_t, ... ) 如果條件已經創建，這個調用相當于 named_condition(open_only_t, ... ) 不拋出

?

• named_condition(open_only_t open_only, const char * name);
• Opens a global condition with a name if that condition is previously created. If it is not previously created this function throws?interprocess_exception.
• 如果之前創建了一個帶有名稱的全局條件，則打開該條件。如果之前沒有創建，則該函數會引發interprocess_exception。

?

• ~named_condition();
• Destroys *this and indicates that the calling process is finished using the resource. The destructor function will deallocate any system resources allocated by the system for use by this process for this resource. The resource can still be opened again calling the open constructor overload. To erase the resource from the system use remove().
• 銷毀*this，并表示調用進程使用該資源結束。該破壞函數將去分配系統為該資源分配的任何系統資源，供該進程使用。該資源仍然可以調用open構造函數重載再次打開。要從系統中刪除資源，使用remove()。

named_condition?public member functions?

• *void notify_one();
• If there is a thread waiting on *this, change that thread's state to ready. Otherwise there is no effect.
• 如果有一個線程在等待*this，則將該線程的狀態改為ready。否則沒有任何影響。

?

• void notify_all();
• Change the state of all threads waiting on *this to ready. If there are no waiting threads, notify_all() has no effect.
• 將所有在*this上等待的線程的狀態改為ready。如果沒有等待的線程，notify_all()就沒有效果。

?

• template<typename L> void wait(L & lock);
• Releases the lock on the?named_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.
• 釋放與鎖相關聯的named_mutex對象的鎖，阻止當前線程的執行，直到調用this->notify_one()或this->notify_all()準備好，然后重新獲取鎖。

?

• template<typename L, typename Pr> void wait(L & lock, Pr pred);
• The same as: while (!pred()) wait(lock)

?

• template<typename L>?bool timed_wait(L & lock, const boost::posix_time::ptime & abs_time);
• Releases the lock on the?named_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.
• 釋放與鎖相關聯的named_mutex對象的鎖，阻止當前線程的執行，直到調用this->notify_one()或this->notify_all()，或者直到達到時間abs_time，然后重新獲取鎖。返回：如果達到時間abs_time，則返回false，否則返回true。

?

• template<typename L, typename Pr>bool timed_wait(L & lock, const boost::posix_time::ptime & abs_time, Pr pred);
• The same as: while (!pred()) { if (!timed_wait(lock, abs_time)) return pred(); } return true;

named_condition?public static functions

• static bool remove(const char * name);
• Erases a named condition from the system. Returns false on error. Never throws.
• 從系統中刪除一個命名的條件。錯誤時返回false。絕不拋出。
  ?

?

?