all Python 3randomterm

random.randrange

integers

Returns a random element of range(start, stop[, step]). Like choice(range(...)), but without building the list.

Syntax

random.randrange(stop)
random.randrange(start, stop[, step])

The upper bound is excluded, exactly like in range: randrange(1, 10) never yields 10 — use randint when you want the endpoint included. An empty range such as randrange(0) or randrange(5, 5) raises ValueError rather than returning None. Since Python 3.12 non-integer arguments are rejected outright: randrange(10.0) raises TypeError, whereas older versions silently converted such values.

Examples

import random
random.seed(0)  # зерно задано — числа воспроизводимы
print(random.randrange(10))     # → 6 — из 0..9, конец не включён
print(random.randrange(1, 10))  # → 7 — из 1..9
print(random.randrange(0, 10, 2))  # → 0 — чётное
print(random.randrange(1, 10, 2))  # → 5 — нечётное

See also

Open in the full glossarydocs.python.orgReport an inaccuracy