retainAll

kotlin-stdlib/kotlin.collections/MutableCollection/retainAll

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@IgnorableReturnValue
expect abstract fun retainAll(elements: Collection<E>): Boolean

Оставляет в этой коллекции только те элементы, которые содержатся в указанной коллекции.

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

true, если из коллекции был удалён хотя бы один элемент, false, если коллекция не была изменена.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val collection: MutableCollection<Char> = mutableSetOf('a', 'b', 'c')

// Nothing was removed
println("collection.retainAll(listOf('a', 'b', 'c')) is ${collection.retainAll(listOf('a', 'b', 'c'))}") // false
println(collection) // [a, b, c]

println("collection.retainAll(listOf('a', 'e', 'i', 'o')) is ${collection.retainAll(listOf('a', 'e', 'i', 'o'))}") // true
println(collection) // [a] 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-collection/retain-all.html