Queue.qsize() better info about unreliability

[nkour]

BPO	1213475
Nosy	@rhettinger

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2005-06-14.08:52:30.000>
created_at = <Date 2005-06-02.12:56:44.000>
labels = ['docs']
title = 'Queue.qsize() better info about unreliability'
updated_at = <Date 2005-06-14.08:52:30.000>
user = 'https://bugs.python.org/nkour'

bugs.python.org fields:

activity = <Date 2005-06-14.08:52:30.000>
actor = 'rhettinger'
assignee = 'none'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2005-06-02.12:56:44.000>
creator = 'nkour'
dependencies = []
files = []
hgrepos = []
issue_num = 1213475
keywords = []
message_count = 3.0
messages = ['25475', '25476', '25477']
nosy_count = 2.0
nosy_names = ['rhettinger', 'nkour']
pr_nums = []
priority = 'normal'
resolution = 'out of date'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue1213475'
versions = []

[nkour]

I know Queues are supposed to be used mostly in threads
apps.
since they are not banned to apps without threads, I
think that

 |  qsize(self)
 |      Return the approximate size of the queue

(not reliable!).

can be better.
You mean not reliable (or unreliable :D) because of
threads right?

if you mean *GENERALLY* because of when ti goes to next
instruction it might have change, then put this not
reliable thing in len() too ;)

I propose:
(urreliable if using threads)

[nkour]

Logged In: YES
user_id=865368

or better:

qsize() :: "Return the approximate size of the queue.
Because of multithreading semantics, this number is not
reliable." (RexxFi)

[rhettinger]

Logged In: YES
user_id=80475

In Py2.4.1, the wording is already:
Because of multithreading semantics, this number is not
reliable.