Функция clear

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

Синтаксис

kotlinfun <T> MutableCollection<T>.clear(): Unit
kotlinfun <K, V> MutableMap<K, V>.clear(): Unit

Пример

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

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

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

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

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

Пример

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

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

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

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

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

Пример

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

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

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

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

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

Пример

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

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

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

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