kotlin-stdlib / kotlin.collections / filterNot

filterNot

Common
JVM
JS
Native
1.0
inline fun <T> Array<out T>.filterNot(
    predicate: (T) -> Boolean
): List<T>
(source)
inline fun ByteArray.filterNot(
    predicate: (Byte) -> Boolean
): List<Byte>
(source)
inline fun ShortArray.filterNot(
    predicate: (Short) -> Boolean
): List<Short>
(source)
inline fun IntArray.filterNot(
    predicate: (Int) -> Boolean
): List<Int>
(source)
inline fun LongArray.filterNot(
    predicate: (Long) -> Boolean
): List<Long>
(source)
inline fun FloatArray.filterNot(
    predicate: (Float) -> Boolean
): List<Float>
(source)
inline fun DoubleArray.filterNot(
    predicate: (Double) -> Boolean
): List<Double>
(source)
inline fun BooleanArray.filterNot(
    predicate: (Boolean) -> Boolean
): List<Boolean>
(source)
inline fun CharArray.filterNot(
    predicate: (Char) -> Boolean
): List<Char>
(source)
inline fun <T> Iterable<T>.filterNot(
    predicate: (T) -> Boolean
): List<T>
(source)
@ExperimentalUnsignedTypes inline fun UIntArray.filterNot(
    predicate: (UInt) -> Boolean
): List<UInt>
(source)
@ExperimentalUnsignedTypes inline fun ULongArray.filterNot(
    predicate: (ULong) -> Boolean
): List<ULong>
(source)
@ExperimentalUnsignedTypes inline fun UByteArray.filterNot(
    predicate: (UByte) -> Boolean
): List<UByte>
(source)
@ExperimentalUnsignedTypes inline fun UShortArray.filterNot(
    predicate: (UShort) -> Boolean
): List<UShort>
(source)

Returns a list containing all elements not matching the given predicate.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val numbers: List<Int> = listOf(1, 2, 3, 4, 5, 6, 7)
val evenNumbers = numbers.filter { it % 2 == 0 }
val notMultiplesOf3 = numbers.filterNot { number -> number % 3 == 0 }

println(evenNumbers) // [2, 4, 6]
println(notMultiplesOf3) // [1, 2, 4, 5, 7]
//sampleEnd
}
Common
JVM
JS
Native
1.0
inline fun <K, V> Map<out K, V>.filterNot(
    predicate: (Entry<K, V>) -> Boolean
): Map<K, V>
(source)

Returns a new map containing all key-value pairs not matching the given predicate.

The returned map preserves the entry iteration order of the original map.

import kotlin.test.*
import java.util.*

fun main(args: Array<String>) {
//sampleStart
val originalMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3)

val filteredMap = originalMap.filterNot { it.value < 3 }
println(filteredMap) // {key3=3}
// original map has not changed
println(originalMap) // {key1=1, key2=2, key3=3}

val matchAllPredicate: ((Map.Entry<String, Int>)) -> Boolean = { it.value > 0 }
val emptyMap = originalMap.filterNot(matchAllPredicate)
println(emptyMap) // {}
//sampleEnd
}