`Iterable.contains` în Kotlin

contains (operatorul in) verifică dacă un element există; indexOf dă poziția primei apariții sau -1.

Sintaxă

operator fun <T> Iterable<T>.contains(element: T): Boolean    // x in colectie
fun <T> Iterable<T>.indexOf(element: T): Int

Ce face `Iterable.contains`

contains(x) întoarce true dacă elementul există în colecție. De obicei se scrie cu operatorul in: x in lista, iar negația cu !in. Compararea se face cu equals (adică ==), deci pentru texte contează literele mari și mici.

indexOf(x) întoarce poziția primei apariții, sau -1 dacă elementul lipsește. lastIndexOf(x) dă ultima apariție.

Pe o listă, căutarea verifică elementele unul câte unul. Dacă faci multe verificări pe o colecție mare, transformă-o în Set: acolo in este aproape instantaneu.

Parametri

Parametru	Descriere
`element`	Valoarea căutată.

Ce returnează

contains: Boolean. indexOf: poziția (Int) sau -1.

Exemple

Exemplul 1: in, !in și indexOf

Pentru „Brașov” poziția este -1, pentru că nu este în listă.

fun main() {
    val traseu = listOf("București", "Ploiești", "Sinaia", "Ploiești", "Buzău")
    println("Sinaia" in traseu)
    println("Brașov" !in traseu)
    println(traseu.contains("ploiești"))
    println("Prima dată prin Ploiești: poziția ${traseu.indexOf("Ploiești")}")
    println("Ultima dată: poziția ${traseu.lastIndexOf("Ploiești")}")
    println("Brașov: ${traseu.indexOf("Brașov")}")
}

Rezultat

true
true
false
Prima dată prin Ploiești: poziția 1
Ultima dată: poziția 3
Brașov: -1

Exemplul 2: Funcționează și pentru data class

Clasele data au equals generat, deci un obiect nou cu aceleași valori este găsit.

data class Loc(val rand: Int, val scaun: Int)

fun main() {
    val ocupate = listOf(Loc(1, 4), Loc(3, 7), Loc(5, 2))
    val cerute = listOf(Loc(3, 7), Loc(3, 8))
    for (loc in cerute) {
        println("$loc ${if (loc in ocupate) "ocupat" else "liber"}")
    }
}