Message 168439 - Python tracker

Message168439

Author	Rostyslav.Dzinko
Recipients	Rostyslav.Dzinko, docs@python
Date	2012-08-17.11:17:57
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1345202279.02.0.767068523185.issue15718@psf.upfronthosting.co.za>
In-reply-to

Content
I've encountered that OverflowError which can happen in __len__ method is still undocumented, though one issue on this problem: http://bugs.python.org/issue12159 ended up with "need to be documented" comment. Link to documentation: http://docs.python.org/reference/datamodel.html#object.__len__ I think it must be clarified that __len__ return value is constrained to upper boundary (Py_ssize_t c type) when you plan to call it via len() built-in function.

Content

I've encountered that OverflowError which can happen in __len__ method is still undocumented, though one issue on this problem: http://bugs.python.org/issue12159 ended up with "need to be documented" comment.

Link to documentation: http://docs.python.org/reference/datamodel.html#object.__len__

I think it must be clarified that __len__ return value is constrained to upper boundary (Py_ssize_t c type) when you plan to call it via len() built-in function.

History
Date	User	Action	Args
2012-08-17 11:17:59	Rostyslav.Dzinko	set	recipients: + Rostyslav.Dzinko, docs@python
2012-08-17 11:17:59	Rostyslav.Dzinko	set	messageid: <1345202279.02.0.767068523185.issue15718@psf.upfronthosting.co.za>
2012-08-17 11:17:58	Rostyslav.Dzinko	link	issue15718 messages
2012-08-17 11:17:57	Rostyslav.Dzinko	create