Merged revisions 83732 via svnmerge from

svn+ssh://pythondev@svn.python.org/python/branches/py3k

........
  r83732 | mark.dickinson | 2010-08-04 19:42:43 +0100 (Wed, 04 Aug 2010) | 3 lines

  Issue #9498:  Add reference to sys.float_info from 'numeric types' docs.
  Thanks Yitz Gale.
........
This commit is contained in:
Mark Dickinson 2010-08-04 18:48:34 +00:00
parent d75efd9c56
commit dd1d8f72f9

View file

@ -224,18 +224,20 @@ Numeric Types --- :class:`int`, :class:`float`, :class:`long`, :class:`complex`
pair: C; language pair: C; language
There are four distinct numeric types: :dfn:`plain integers`, :dfn:`long There are four distinct numeric types: :dfn:`plain integers`, :dfn:`long
integers`, :dfn:`floating point numbers`, and :dfn:`complex numbers`. In integers`, :dfn:`floating point numbers`, and :dfn:`complex numbers`. In
addition, Booleans are a subtype of plain integers. Plain integers (also just addition, Booleans are a subtype of plain integers. Plain integers (also just
called :dfn:`integers`) are implemented using :ctype:`long` in C, which gives called :dfn:`integers`) are implemented using :ctype:`long` in C, which gives
them at least 32 bits of precision (``sys.maxint`` is always set to the maximum them at least 32 bits of precision (``sys.maxint`` is always set to the maximum
plain integer value for the current platform, the minimum value is plain integer value for the current platform, the minimum value is
``-sys.maxint - 1``). Long integers have unlimited precision. Floating point ``-sys.maxint - 1``). Long integers have unlimited precision. Floating point
numbers are implemented using :ctype:`double` in C. All bets on their precision numbers are usually implemented using :ctype:`double` in C; information about
are off unless you happen to know the machine you are working with. the precision and internal representation of floating point numbers for the
machine on which your program is running is available in
Complex numbers have a real and imaginary part, which are each implemented using :data:`sys.float_info`. Complex numbers have a real and imaginary part, which
:ctype:`double` in C. To extract these parts from a complex number *z*, use are each a floating point number. To extract these parts from a complex number
``z.real`` and ``z.imag``. *z*, use ``z.real`` and ``z.imag``. (The standard library includes additional
numeric types, :mod:`fractions` that hold rationals, and :mod:`decimal` that
hold floating-point numbers with user-definable precision.)
.. index:: .. index::
pair: numeric; literals pair: numeric; literals