Changeset 2759 in Sophya

Timestamp:

May 24, 2005, 6:29:28 PM (20 years ago)

Author:

ansari

Message:

Amelioration de l'interface ZSync() + ajout commentaires - Reza 24/05/2005

Location:

trunk/SophyaLib/SysTools

Files:

• zthread.cc (modified) (1 diff)
• zthread.h (modified) (4 diffs)

trunk/SophyaLib/SysTools/zthread.cc

@@ -138 +138 @@
   of the POSIX threads. 
   The ZMutex objects should be used to control acces from different threads 
-  to common objects through the \b lock() and \b unlock() methods.  
+  to common objects through the \b lock() and \b unlock() methods. 
+  When the \b signal() method is called, one of the waiting threads
+  on the corresponding mutex object (\b ZMutex::wait()) is awakened. 
+  All waiting threads on the mutex object are awakened when \b broadcast()
+  is called.
   \sa SOPHYA::ZSync
 */

trunk/SophyaLib/SysTools/zthread.h

@@ -77 +77 @@
   inline void   wait()
     { pthread_cond_wait(_condv, _mutx); }
-  //! Signal a condition change on the mutex object
+  //! Signal a condition change on the mutex object. 
   inline void   signal()
   { pthread_cond_signal(_condv); }
@@ -95 +95 @@
   Constructor. Locks the associated ZMutex. 
   
+  - <tt> sigbr==0 </tt> No calls to signal() or broadcast() 
+  in destructor 
   - <tt> sigbr==1 </tt> destructor calls \c signal on 
   the associated ZMutex 
@@ -101 +103 @@
 */
   explicit inline  ZSync(ZMutex & mtx, int sigbr=0) 
-  {_mtx = &mtx; _sigbr = sigbr; mtx.lock(); }
+  {_mtx = &mtx; _sigbr = sigbr; _mtx->lock(); }
+
+/*!
+  Constructor from ZMutex pointer. 
+  Locks the associated ZMutex object if non null pointer 
+*/ 
+  explicit inline  ZSync(ZMutex * mtxp, int sigbr=0) 
+  {_mtx = mtxp; _sigbr = sigbr; if (_mtx) _mtx->lock(); }
   inline           ~ZSync() 
   { 
@@ -110 +119 @@
     }
   }
+//! Calls the wait method on the associated ZMutex object
+  inline void wait() { if (_mtx) _mtx->wait(); }
 //! To avoid warnings about unused variables 
   inline int NOp() { return _sigbr; }