3 |
* LinuxSampler - modular, streaming capable sampler * |
* LinuxSampler - modular, streaming capable sampler * |
4 |
* * |
* * |
5 |
* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck * |
* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck * |
6 |
|
* Copyright (C) 2005 - 2007 Christian Schoenebeck * |
7 |
* * |
* * |
8 |
* This program is free software; you can redistribute it and/or modify * |
* This program is free software; you can redistribute it and/or modify * |
9 |
* it under the terms of the GNU General Public License as published by * |
* it under the terms of the GNU General Public License as published by * |
26 |
|
|
27 |
#include "Mutex.h" |
#include "Mutex.h" |
28 |
|
|
29 |
|
namespace LinuxSampler { |
30 |
|
|
31 |
/** |
/** |
32 |
* Thread safe boolean condition. |
* Thread safe boolean condition. |
33 |
* |
* |
46 |
/** |
/** |
47 |
* Destructor |
* Destructor |
48 |
*/ |
*/ |
49 |
~Condition(); |
virtual ~Condition(); |
50 |
|
|
51 |
/** |
/** |
52 |
* Blocks the calling thread if current condition equals |
* Blocks the calling thread if current condition equals |
56 |
* critical section and has to explicitly call Unlock() right after |
* critical section and has to explicitly call Unlock() right after |
57 |
* it left it's critcal section. |
* it left it's critcal section. |
58 |
* |
* |
59 |
|
* @e Note: If you don't provide a timeout value or if you provide a |
60 |
|
* timeout value of exactly 0s and 0ns, then this call will block |
61 |
|
* without any timeout, or in other words: @e infinity! |
62 |
|
* |
63 |
* @param bCondition - block in case of this condition |
* @param bCondition - block in case of this condition |
64 |
* @param TimeoutSeconds - optional: max. wait time in seconds |
* @param TimeoutSeconds - optional: max. wait time in seconds |
65 |
* (default: 0s) |
* (default: 0s) |
74 |
* Condition object, so only use this call if you don't need to |
* Condition object, so only use this call if you don't need to |
75 |
* enter a thread critical section, otherwise use WaitIf() instead! |
* enter a thread critical section, otherwise use WaitIf() instead! |
76 |
* |
* |
77 |
|
* @e Note: If you don't provide a timeout value or if you provide a |
78 |
|
* timeout value of exactly 0s and 0ns, then this call will block |
79 |
|
* without any timeout, or in other words: @e infinity! |
80 |
|
* |
81 |
* @param bCondition - block in case of this condition |
* @param bCondition - block in case of this condition |
82 |
* @param TimeoutSeconds - optional: max. wait time in seconds |
* @param TimeoutSeconds - optional: max. wait time in seconds |
83 |
* (default: 0s) |
* (default: 0s) |
98 |
*/ |
*/ |
99 |
void Set(bool bCondition); |
void Set(bool bCondition); |
100 |
|
|
101 |
|
/** |
102 |
|
* Returns the current boolean state of this condition object. This |
103 |
|
* method never blocks, it returns immediately and doesn't use any |
104 |
|
* system calls. |
105 |
|
* |
106 |
|
* @e Caution: this method is not thread safe! If you need to use |
107 |
|
* the condition state in a thread critical context you must call |
108 |
|
* @c Lock() and @c Unlock() respectively by yourself! |
109 |
|
*/ |
110 |
|
bool GetUnsafe(); |
111 |
|
|
112 |
protected: |
protected: |
113 |
pthread_cond_t __posix_true_condition; |
pthread_cond_t __posix_true_condition; |
114 |
pthread_cond_t __posix_false_condition; |
pthread_cond_t __posix_false_condition; |
115 |
bool bCondition; |
bool bCondition; |
116 |
}; |
}; |
117 |
|
|
118 |
|
} // namespace LinuxSampler |
119 |
|
|
120 |
#endif // __CONDITION_H__ |
#endif // __CONDITION_H__ |