Condition.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:5k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(VOCAL_CONDITION_HXX)
  2. #define VOCAL_CONDITION_HXX
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const Condition_hxx_version =
  53.     "$Id: Condition.hxx,v 1.1 2001/03/23 13:43:10 icahoon Exp $";
  54. #include "NonCopyable.hxx"
  55. #include "Mutex.hxx"
  56. /** Infrastructure common to VOCAL.
  57.  */
  58. namespace Vocal 
  59. {
  60. /** Infrastructure common to VOCAL to create and manage threads.
  61.  */
  62. namespace Threads
  63. {
  64. /** Defines a simple conditional variable class which
  65.  *  allows threads to block until shared data changes state.
  66.  *  A VCondition must always be associated with a
  67.  *  VMutex to avoid the race condition where a thread prepares to
  68.  *  wait on a condition variable and another thread signals the
  69.  *  condition just before the first thread actually waits on it.
  70.  */
  71. class Condition : public NonCopyable
  72. {
  73.     public:
  74.         /** Create an Condition object initialized with operating system
  75.          *  dependant defaults (if any). 
  76.          */
  77.         Condition();
  78.         /** Delete a Condition object
  79.          */
  80.         virtual ~Condition();
  81.         /** Block on the condition. Will return after the relativeTime, 
  82.          *  specified in millseconds, has passed. If set to -1, the default,
  83.          *  it will wait indefinately. Uses the specified mutex to synchronize 
  84.          *  access to the condition. Returns 0, if successful, or an errorcode.
  85.          */
  86.         int wait (Mutex* mutex, int relativeTimeInMillis = -1);
  87.         /** Block on the condition. Will return after the relativeTime, 
  88.          *  specified in microseconds, has passed. If set to -1, the default,
  89.          *  it will wait indefinately. Uses the specified mutex to synchronize 
  90.          *  access to the condition. Returns 0, if successful, or an errorcode.
  91.          */
  92.         int uwait(Mutex* mutex, int relativeTimeInMicros = -1);
  93.         /** Signal one waiting thread.
  94.          *  Returns 0, if successful, or an errorcode.
  95.          */
  96.         int signal();
  97.         /** Signal all waiting threads.
  98.          *  Returns 0, if successful, or an errorcode.
  99.          */
  100.         int broadcast();
  101.          
  102.         /** Returns the operating system dependent unique id of the condition.
  103.          */
  104.         const vcondition_t*
  105.         getId() const;
  106.     private:
  107.         mutable vcondition_t myId;
  108. };
  109. } // namespace Threads
  110. } // namespace Vocal
  111. /** usleep() replacement.<br><br> 
  112.  *
  113.  *  This will not throw a SIGALRM.
  114.  */
  115. void vusleep(unsigned long usec);
  116. #endif // !defined(VOCAL_CONDITION_HXX)