[issue21611] int() docstring - unclear what number is

Change by Cheryl Sabella : -- resolution: -> duplicate stage: -> resolved status: open -> closed superseder: -> Documentation for int constructor mentions __int__ but not __trunc__ ___ Python tracker

[issue21611] int() docstring - unclear what number is

Dmitry Andreychuk added the comment: I created this issue almost 4 years ago. Looking at it now, I think that I was asking too much of that docstring. I believe it's current version quite sufficient. I would close the issue, but I'm not sure if it's up to me to decide.

[issue21611] int() docstring - unclear what number is

Cheryl Sabella added the comment: Is this superseded by issue 26701? -- nosy: +csabella ___ Python tracker ___

[issue21611] int() docstring - unclear what number is

Changes by Chris Rebert pyb...@rebertia.com: -- nosy: +cvrebert ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21611 ___ ___ Python-bugs-list

[issue21611] int() docstring - unclear what number is

Changes by Martin Panter vadmium...@gmail.com: -- nosy: +vadmium ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21611 ___ ___ Python-bugs-list

[issue21611] int() docstring - unclear what number is

Dmitry Andreychuk added the comment: Now I see that my message may look like a suggestion to add an encyclopedic definition of number there. Sorry. Actually I was talking about requirements for user-defined types to make them work with int(). Something like: If x has __int__() method return

[issue21611] int() docstring - unclear what number is

eryksun added the comment: The constructor tries __trunc__ (truncate toward 0) if __int__ isn't defined. If __trunc__ doesn't return an instance of int, it calls the intermediate result's __int__ method. In terms of the numbers ABCs, numbers.Real requires __trunc__, which should return a

[issue21611] int() docstring - unclear what number is

Raymond Hettinger added the comment: I think there should be a precise definition of what is considered to be a number there. Sometimes precise definitions make the docs harder to use rather than easier. It is the goal of these docs to basically tell what int() does, not to provide a spec

[issue21611] int() docstring - unclear what number is

Changes by Ezio Melotti ezio.melo...@gmail.com: -- nosy: +ezio.melotti, zach.ware type: - enhancement versions: -Python 3.1, Python 3.2, Python 3.3 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue21611

[issue21611] int() docstring - unclear what number is

New submission from Dmitry Andreychuk: https://docs.python.org/3.4/library/functions.html?highlight=int#int The docstring for int() function has these sentences: If x is a number, return x.__int__(). If x is not a number or if base is given... Unfortunately the docstring doesn't describe how