Справочник по функциям Python

random.shuffle

Перемешивает элементы списка в случайном порядке.

Python 3.13
random.shuffle(x)

Параметры

xlist
Список, который нужно перемешать.

Возвращаемое значение

Ничего (None) — список меняется на месте.

Примеры

Перемешивание колоды

Python 3.13
import random

random.seed(1)
cards = ['A', 'K', 'Q', 'J']
random.shuffle(cards)
print(cards)
['J', 'A', 'Q', 'K']

Перемешанная копия через random.sample

Python 3.13
import random

random.seed(3)
names = ['Anna', 'Boris', 'Vera']
shuffled = random.sample(names, k=len(names))
print(names)
print(shuffled)
['Anna', 'Boris', 'Vera']
['Anna', 'Vera', 'Boris']

Подробности

Список перемешивается на месте, а функция возвращает None: запись cards = random.shuffle(cards) потеряет список. Строку и кортеж перемешать нельзя — они неизменяемые; перемешанную копию любой последовательности даёт random.sample(x, k=len(x)).

Смотрите также

Где изучить