ClearUserList
ClearUserList — полностью очищает указанный список пользователей.
📝 Назначение
Удаляет всех пользователей из списка одним действием. Список остаётся существовать, но становится пустым.
Когда это нужно:
- Подготовка списка к новому розыгрышу или мероприятию
- Полная очистка временной группы после завершения задачи
- Сброс чёрного списка после снятия всех ограничений
🔴 Важно: Операция необратима. Восстановить удалённых пользователей можно только повторным добавлением через
AddToUserList.
⚙️ Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| Список пользователей | Выбор из списка | ✅ Да | Имя списка для очистки |
🔄 Отличие от DelFromUserList
| Характеристика | ClearUserList | DelFromUserList |
|---|---|---|
| Что делает | Удаляет всех пользователей | Удаляет конкретного пользователя |
| Скорость | Мгновенно | Мгновенно |
| Восстановление | Только повторное добавление | Только повторное добавление |
💡 Совет: Используйте
ClearUserListдля полной очистки списка. Если нужно удалить только одного пользователя — используйтеDelFromUserList.
🧪 Примеры использования
Пример 1: Очистка списка участников после розыгрыша
Задача: После завершения розыгрыша очистить список contest_participants для следующего мероприятия.
Параметры ClearUserList:
Список пользователей:contest_participants
Пример 2: Сброс чёрного списка
Задача: Полностью очистить чёрный список blacklist после общего прощения.
Параметры ClearUserList:
Список пользователей:blacklist
Пример 3: Очистка списка перед новой кампанией
Задача: Очистить список subscribers перед запуском новой рекламной кампании.
Параметры ClearUserList:
Список пользователей:subscribers
🔄 Особенности поведения
| Ситуация | Поведение |
|---|---|
| Список уже пуст | Ничего не происходит (ошибки нет) |
| Список не существует | Реакция вызовет ошибку |
| В списке тысячи пользователей | Очистка происходит мгновенно |
🔗 Связанные реакции
| Реакция | Назначение |
|---|---|
| AddToUserList | Добавить пользователя в список |
| DelFromUserList | Удалить конкретного пользователя |
| LoadUserList | Загрузить содержимое списка |
| TakeUserList | Получить список для массовой обработки |
🔗 Связанные разделы
| Раздел | Описание |
|---|---|
| Списки пользователей | Общая информация о списках |
| Условие InUserList | Проверка вхождения в список |