This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Title: threading.Condition.wait() return value indicates timeout
Type: enhancement Stage:
Components: Library (Lib) Versions: Python 2.6
Status: closed Resolution: rejected
Dependencies: Superseder:
Assigned To: Nosy List: benjamin.peterson, bgnori, blais, christian.heimes, gvanrossum, mdehoon, tim.peters
Priority: normal Keywords: easy, patch

Created on 2005-04-03 19:09 by blais, last changed 2022-04-11 14:56 by admin. This issue is now closed.

File name Uploaded Description Edit
wait-return-value.patch blais, 2005-04-03 19:09 Patch to add return value to threading.Condition.wait()
Messages (8)
msg48139 - (view) Author: Martin Blais (blais) * (Python committer) Date: 2005-04-03 19:09
A condition variable returns in two cases: it was
notified by another thread, or it timed out (if a
timeout was specified).  See an example in the popular
Boost C++ library:

This patch adds this capability to the Python
threading.Condition.wait() method, which used to return
nothing.  I added the relevant couple of lines to the
documentaion as well (see patch).

(An example is using a condition variable as a sentinel
for exiting a loop or a polling thread.  Using the
return value one can decide whether to exit the loop or
msg48140 - (view) Author: Michiel de Hoon (mdehoon) * Date: 2005-04-29 06:59
Logged In: YES 

This looks like a good idea to me. It will help to clean up
the "get" method in, which now has:

                while self._empty():
                    remaining = endtime - _time()
                    if remaining <= 0.0:
                        raise Empty

Here, self.not_empty is an object of the class
threading.Condition. It seems odd that first we wait for
self.not_empty.wait to return, and then have to check
self._empty(), even though self.not_empty.wait could have
told us directly if it was notified or it timed out.

I'll write a message to python-dev in support of this patch
(I'm a mere patch reviewer, not an official Python developer).
msg48141 - (view) Author: Tim Peters (tim.peters) * (Python committer) Date: 2005-04-30 04:39
Logged In: YES 

Sorry, I think this is a poor idea, and mdehoon's suggestion 
for turning a correct use of .wait() into a doubly buggy one 
illustrates why:  there's no guarantee that self._empty() will 
return false just because .wait() returns without timing out --
 .wait() returning just means that it may not be a waste of 
time to check for the desired condition.  "notifying" a condvar 
emphatically does not mean that the desired condition holds, 
and any number of other threads can run for any amount of 
time between the times a condvar is notified and some wait()
er wakes up (so even if the desired condition does hold at the 
time notify() is called, it may not anymore by the time a wait()
er wakes).

The check should always be done when .wait() doesn't time 
out, and even if .wait() does time out, self._empty() may 
return false anyway.

Note too that .wait()'s caller holds the associated mutex 
regardless of whether return is due to timeout or notify, and 
the caller needs to release it again in either case.  Creating a 
distinction based on return value creates a new opportunity to 
screw up that part too.

I don't understand this:

> An example is using a condition variable as a sentinel
> for exiting a loop or a polling thread. Using the
> return value one can decide whether to exit the loop or
> not.)

To the extent that I might understand it, it sounds like a 
condvar is gross overkill, and that you'd want something 
simpler (perhaps an Event) in those cases.  But I can't flesh 
out the code you have in mind there.
msg48142 - (view) Author: Martin Blais (blais) * (Python committer) Date: 2005-04-30 14:03
Logged In: YES 

hi tim
thanks for the comments.

my use of a condition variable is exemplified in this
background thread, which computes something periodically,
and with which the main thread uses a condition variable to
communicate "pause" and "quit" states (there is
communication between only those two threads):

def background_thread( func, args, condvar, callbacks, delay ):
    A background thread that computes something periodically.

    @func: function that computes something;
    @data: arguments for function that computes something;
    @condvar: a variable to indicate for the thread to stop
or pause.
              The variable is the 'pause' and 'quit' members
on the condvar.
    @callbacks: a list of functions to call when a new
result becomes available;
    done = 0
    while not done:
        # compute something
        data = func(*args)
        # push the new data into the callbacks
        for cb in callbacks:

        if condvar.pause:
            # this branch is used to pause the thread.
        if condvar.quit:
            done = 1

instead of using the "quit" data member, i could instead use
the return value of the wait() call.  basically, exit the
loop when i've been signaled.

AFAIK this is a common usage pattern. i've seen it in a few
places.  do you see any problem with this usage?

not that it's really an argument, but i did see 3
independent implementations of wait() returning the
signaled/timeout boolean.

i think Event.wait() should also return the signaled/timeout
state.  it's information that should be returned to the
user, whether he uses it or not.  sure, people can screw up,
but if there is a legitimate case where it can be used, i
think it should be provided anyway.

also, you are correct about mdehoon's case, after returning
from wait(), one should check for the queue being empty or not.

msg60173 - (view) Author: Christian Heimes (christian.heimes) * (Python committer) Date: 2008-01-19 14:42
Another bug day task.
msg63115 - (view) Author: Noriyuki Hosaka (bgnori) Date: 2008-02-29 01:24
I have a question:
 Why not to raise an exception?

Timeout means "something has messed up, can not continue."
We are not doing task scheduling, aren't we?
msg63123 - (view) Author: Benjamin Peterson (benjamin.peterson) * (Python committer) Date: 2008-02-29 03:13
I don't think an exception is the proper thing to use here. Having the
wait timeout is not exceptional or unexpected.
> Timeout means "something has messed up, can not continue."
Not really. It means "we didn't want to wait this long to be notified."
msg84567 - (view) Author: Guido van Rossum (gvanrossum) * (Python committer) Date: 2009-03-30 15:45
Since Tim Peters is the absolute authority on concurrency in Python,
let's just close this as Rejected rather than letting it sit here forever.
Date User Action Args
2022-04-11 14:56:10adminsetgithub: 41798
2009-03-30 15:45:36gvanrossumsetstatus: open -> closed

nosy: + gvanrossum
messages: + msg84567

resolution: rejected
2008-02-29 03:13:07benjamin.petersonsetnosy: + benjamin.peterson
messages: + msg63123
2008-02-29 01:24:19bgnorisetnosy: + bgnori
messages: + msg63115
2008-01-19 14:42:13christian.heimessetkeywords: + easy
nosy: + christian.heimes
type: enhancement
messages: + msg60173
versions: + Python 2.6, - Python 2.4
2005-04-03 19:09:47blaiscreate