mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-13 15:40:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Improve the threading.Condition docs.

Browse source
This commit is contained in:
Antoine Pitrou 2012-04-11 19:37:56 +02:00
parent 2c5807572f
commit f6cd9b2d46
1 changed files with 5 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
Doc/library/threading.rst
View file

@ -561,12 +561,14 @@ producer-consumer situation with unlimited buffer capacity::
# Produce one item # Produce one item
with cv: with cv:
make_an_item_available() make_an_item_available()
cv.notify()
The ``while`` loop checking for the application's condition is necessary The ``while`` loop checking for the application's condition is necessary
because :meth:`~Condition.wait` can return after an arbitrary long time, because :meth:`~Condition.wait` can return after an arbitrary long time,
and other threads may have exhausted the available items in between. This and the condition which prompted the :meth:`~Condition.notify` call may
is inherent to multi-threaded programming. The :meth:`~Condition.wait_for` no longer hold true. This is inherent to multi-threaded programming. The
method can be used to automate the condition checking:: :meth:`~Condition.wait_for` method can be used to automate the condition
checking, and eases the computation of timeouts::
# Consume an item # Consume an item
with cv: with cv: