diff options
Diffstat (limited to 'Doc/library/random.rst')
| -rw-r--r-- | Doc/library/random.rst | 25 |
1 files changed, 15 insertions, 10 deletions
diff --git a/Doc/library/random.rst b/Doc/library/random.rst index ab4ca4b..f37bc2a 100644 --- a/Doc/library/random.rst +++ b/Doc/library/random.rst @@ -104,21 +104,16 @@ Bookkeeping functions the time :func:`getstate` was called. -.. function:: getrandbits(k) - - Returns a Python integer with *k* random bits. This method is supplied with - the Mersenne Twister generator and some other generators may also provide it - as an optional part of the API. When available, :meth:`getrandbits` enables - :meth:`randrange` to handle arbitrarily large ranges. - - .. versionchanged:: 3.9 - This method now accepts zero for *k*. - +Functions for bytes +------------------- .. function:: randbytes(n) Generate *n* random bytes. + This method should not be used for generating security tokens. + Use :func:`secrets.token_bytes` instead. + .. versionadded:: 3.9 @@ -145,6 +140,16 @@ Functions for integers Return a random integer *N* such that ``a <= N <= b``. Alias for ``randrange(a, b+1)``. +.. function:: getrandbits(k) + + Returns a Python integer with *k* random bits. This method is supplied with + the MersenneTwister generator and some other generators may also provide it + as an optional part of the API. When available, :meth:`getrandbits` enables + :meth:`randrange` to handle arbitrarily large ranges. + + .. versionchanged:: 3.9 + This method now accepts zero for *k*. + Functions for sequences ----------------------- |