Improve docs for random.seed()

This commit is contained in:
Raymond Hettinger 2016-09-04 11:17:28 -07:00
parent ab7b0a03b5
commit 16eb827b33
2 changed files with 10 additions and 5 deletions

View File

@ -63,8 +63,11 @@ Bookkeeping functions:
If *a* is an int, it is used directly. If *a* is an int, it is used directly.
With version 2 (the default), a :class:`str`, :class:`bytes`, or :class:`bytearray` With version 2 (the default), a :class:`str`, :class:`bytes`, or :class:`bytearray`
object gets converted to an :class:`int` and all of its bits are used. With version 1, object gets converted to an :class:`int` and all of its bits are used.
the :func:`hash` of *a* is used instead.
With version 1 (provided for reproducing random sequences from older versions
of Python), the algorithm for :class:`str` and :class:`bytes` generates a
narrower range of seeds.
.. versionchanged:: 3.2 .. versionchanged:: 3.2
Moved to the version 2 scheme which uses all of the bits in a string seed. Moved to the version 2 scheme which uses all of the bits in a string seed.

View File

@ -96,11 +96,13 @@ class Random(_random.Random):
None or no argument seeds from current time or from an operating None or no argument seeds from current time or from an operating
system specific randomness source if available. system specific randomness source if available.
For version 2 (the default), all of the bits are used if *a* is a str,
bytes, or bytearray. For version 1, the hash() of *a* is used instead.
If *a* is an int, all bits are used. If *a* is an int, all bits are used.
For version 2 (the default), all of the bits are used if *a* is a str,
bytes, or bytearray. For version 1 (provided for reproducing random
sequences from older versions of Python), the algorithm for str and
bytes generates a narrower range of seeds.
""" """
if a is None: if a is None: