Функция clear

Функция clear используется для полной очистки коллекции. После вызова этой функции коллекция становится пустой. Функция не возвращает никакого значения. Применяется к изменяемым коллекциям: MutableList, MutableSet, MutableMap.

Синтаксис

fun <T> MutableCollection<T>.clear(): Unit

fun <K, V> MutableMap<K, V>.clear(): Unit

Пример

Очистим изменяемый список чисел:

val numbers = mutableListOf(1, 2, 3, 4, 5)
println("Before clear: $numbers")

numbers.clear()
println("After clear: $numbers")

Результат выполнения кода:

Before clear: [1, 2, 3, 4, 5]
After clear: []

Пример

Очистим изменяемое множество строк:

val fruits = mutableSetOf("apple", "banana", "orange")
println("Before clear: $fruits")

fruits.clear()
println("After clear: $fruits")

Результат выполнения кода:

Before clear: [apple, banana, orange]
After clear: []

Пример

Очистим изменяемый словарь:

val users = mutableMapOf(1 to "John", 2 to "Alice", 3 to "Bob")
println("Before clear: $users")

users.clear()
println("After clear: $users")

Результат выполнения кода:

Before clear: {1=John, 2=Alice, 3=Bob}
After clear: {}

Пример

Попытка очистить неизменяемую коллекцию вызовет ошибку компиляции:

val immutableList = listOf(1, 2, 3)
immutableList.clear() // Error: Unresolved reference: clear

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

функцию remove,
которая удаляет один элемент из коллекции
функцию removeAll,
которая удаляет несколько элементов из коллекции
функцию isEmpty,
которая проверяет пуста ли коллекция
функцию isNotEmpty,
которая проверяет не пуста ли коллекция