:mod:`urandom` -- Random Number Generation
==========================================

.. module:: urandom
   :synopsis: Random Number Generation

The module ''urandom'' provides functions for random number generation.   ''urandom'' is based upon the ``random`` module in the Python standard library.

.. only:: port_sl3 or port_xlink


Functions
---------

.. only:: port_sl3 or port_xlink

	.. function:: getrandbits(n)

	    Returns an integer with ``n`` random bits where n may be between 1-32 (inclusive).

.. only:: port_sl3 or port_xlink

	.. function:: seed(n)

	    Initialize the random number generator with a known integer ``n``. This
	    will give you reproducibly deterministic randomness from a given starting
	    state (``n``).

.. only:: port_sl3 or port_xlink

	.. function:: randint(a, b)

	    Return a random integer ``N`` such that ``a <= N <= b``. Alias for
	    ``randrange(a, b+1)``.

.. only:: port_sl3 or port_xlink

	.. function:: randrange(stop)

	    Return a randomly selected integer between zero and up to (but not
	    including) ``stop``.

.. only:: port_sl3 or port_xlink

	.. function:: randrange(start, stop)

	    Return a randomly selected integer from ``range(start, stop)``.

.. only:: port_sl3 or port_xlink

	.. function:: randrange(start, stop, step)

	    Return a randomly selected element from ``range(start, stop, step)``.

.. only:: port_sl3 or port_xlink

	.. function:: choice(seq)

	    Return a random element from the non-empty sequence ``seq``. If ``seq`` is
	    empty, raises ``IndexError``.

.. only:: port_sl3 or port_xlink

	.. function:: random()

	    Return the next random floating point number in the range [0.0, 1.0)

.. only:: port_sl3 or port_xlink

	.. function:: uniform(a, b)

	    Return a random floating point number ``N`` such that ``a <= N <= b``
	    for ``a <= b`` and ``b <= N <= a`` for ``b < a``.