any

fun <T> Array<out T>.any(): Boolean
fun ByteArray.any(): Boolean
fun ShortArray.any(): Boolean
fun IntArray.any(): Boolean
fun LongArray.any(): Boolean
fun FloatArray.any(): Boolean
fun DoubleArray.any(): Boolean
fun BooleanArray.any(): Boolean
fun CharArray.any(): Boolean

Returns true if array has at least one element.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val emptyList = emptyList<Int>()
assertFalse(emptyList.any())

val nonEmptyList = listOf(1, 2, 3)
assertTrue(nonEmptyList.any()) 
   //sampleEnd
}

inline fun <T> Array<out T>.any(predicate: (T) -> Boolean): Boolean
inline fun ByteArray.any(predicate: (Byte) -> Boolean): Boolean
inline fun ShortArray.any(predicate: (Short) -> Boolean): Boolean
inline fun IntArray.any(predicate: (Int) -> Boolean): Boolean
inline fun LongArray.any(predicate: (Long) -> Boolean): Boolean
inline fun FloatArray.any(predicate: (Float) -> Boolean): Boolean
inline fun DoubleArray.any(predicate: (Double) -> Boolean): Boolean
inline fun BooleanArray.any(predicate: (Boolean) -> Boolean): Boolean
inline fun CharArray.any(predicate: (Char) -> Boolean): Boolean
inline fun <T> Iterable<T>.any(predicate: (T) -> Boolean): Boolean

Returns true if at least one element matches the given predicate.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val isEven: (Int) -> Boolean = { it % 2 == 0 }
val zeroToTen = 0..10
assertTrue(zeroToTen.any { isEven(it) })
assertTrue(zeroToTen.any(isEven))

val odds = zeroToTen.map { it * 2 + 1 }
assertFalse(odds.any { isEven(it) })

val emptyList = emptyList<Int>()
assertFalse(emptyList.any { true }) 
   //sampleEnd
}

fun <T> Iterable<T>.any(): Boolean

Returns true if collection has at least one element.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val emptyList = emptyList<Int>()
assertFalse(emptyList.any())

val nonEmptyList = listOf(1, 2, 3)
assertTrue(nonEmptyList.any()) 
   //sampleEnd
}

fun <K, V> Map<out K, V>.any(): Boolean

Returns true if map has at least one entry.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val emptyList = emptyList<Int>()
assertFalse(emptyList.any())

val nonEmptyList = listOf(1, 2, 3)
assertTrue(nonEmptyList.any()) 
   //sampleEnd
}

inline fun <K, V> Map<out K, V>.any(predicate: (Map.Entry<K, V>) -> Boolean): Boolean

Returns true if at least one entry matches the given predicate.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val isEven: (Int) -> Boolean = { it % 2 == 0 }
val zeroToTen = 0..10
assertTrue(zeroToTen.any { isEven(it) })
assertTrue(zeroToTen.any(isEven))

val odds = zeroToTen.map { it * 2 + 1 }
assertFalse(odds.any { isEven(it) })

val emptyList = emptyList<Int>()
assertFalse(emptyList.any { true }) 
   //sampleEnd
}

inline fun UIntArray.any(): Boolean
inline fun ULongArray.any(): Boolean
inline fun UByteArray.any(): Boolean
inline fun UShortArray.any(): Boolean

Returns true if array has at least one element.

Since Kotlin

1.3

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val emptyList = emptyList<Int>()
assertFalse(emptyList.any())

val nonEmptyList = listOf(1, 2, 3)
assertTrue(nonEmptyList.any()) 
   //sampleEnd
}

inline fun UIntArray.any(predicate: (UInt) -> Boolean): Boolean
inline fun ULongArray.any(predicate: (ULong) -> Boolean): Boolean
inline fun UByteArray.any(predicate: (UByte) -> Boolean): Boolean
inline fun UShortArray.any(predicate: (UShort) -> Boolean): Boolean

Returns true if at least one element matches the given predicate.

Since Kotlin

1.3

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val isEven: (Int) -> Boolean = { it % 2 == 0 }
val zeroToTen = 0..10
assertTrue(zeroToTen.any { isEven(it) })
assertTrue(zeroToTen.any(isEven))

val odds = zeroToTen.map { it * 2 + 1 }
assertFalse(odds.any { isEven(it) })

val emptyList = emptyList<Int>()
assertFalse(emptyList.any { true }) 
   //sampleEnd
}