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.

Author steven.daprano
Recipients docs@python, steven.daprano
Date 2022-03-15.22:47:25
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1647384445.54.0.624569737197.issue47031@roundup.psfhosted.org>
In-reply-to
Content
The IEEE-754 requirement that NANs are never equal to anything, even to themselves, is a common stumbling block for those new to the consequences of IEEE-754. See for example #47020.

The documentation for math.nan would be a good place to add a note like

"Due to the requirements of the `IEEE-754 standard <https://en.wikipedia.org/wiki/IEEE_754>`_, math.nan and float('nan') are never equal to any other value, including themselves. Use math.isnan to test for NANs."

https://docs.python.org/3.8/library/math.html#math.nan
History
Date User Action Args
2022-03-15 22:47:25steven.dapranosetrecipients: + steven.daprano, docs@python
2022-03-15 22:47:25steven.dapranosetmessageid: <1647384445.54.0.624569737197.issue47031@roundup.psfhosted.org>
2022-03-15 22:47:25steven.dapranolinkissue47031 messages
2022-03-15 22:47:25steven.dapranocreate