단일 요소 검색

Kotlin 컬렉션은 컬렉션에서 단일 요소를 검색하는 함수들을 제공합니다. 이 페이지에서 설명하는 함수들은 리스트와 세트 모두에 적용됩니다.

리스트 정의에 명시된 바와 같이, 리스트는 순서가 있는 컬렉션입니다. 따라서 리스트의 모든 요소는 참조에 사용할 수 있는 고유한 위치를 가집니다. 이 페이지에서 설명하는 함수 외에도, 리스트는 인덱스를 통해 요소를 검색하고 찾는 더 다양한 방법을 제공합니다. 자세한 내용은 리스트별 연산을 참조하세요.

반면에 세트는 정의에 따라 순서가 있는 컬렉션이 아닙니다. 하지만 Kotlin Set은 특정 순서로 요소를 저장합니다. 이는 삽입 순서(LinkedHashSet), 자연 정렬 순서(SortedSet) 또는 다른 순서일 수 있습니다. 세트 요소의 순서는 알려지지 않을 수도 있습니다. 이러한 경우에도 요소들은 여전히 어떤 식으로든 정렬되어 있으므로, 요소 위치에 의존하는 함수들은 결과를 반환합니다. 하지만 호출자가 사용된 Set의 특정 구현을 알지 못한다면 이러한 결과는 예측할 수 없습니다.

위치별 검색

특정 위치의 요소를 검색하려면 elementAt() 함수를 사용합니다. 정수를 인수로 호출하면, 주어진 위치에 있는 컬렉션 요소를 얻을 수 있습니다. 첫 번째 요소는 0 위치를 가지며, 마지막 요소는 (size - 1) 위치를 가집니다.

elementAt()는 인덱스 액세스를 제공하지 않거나, 정적으로 인덱스 액세스를 제공하는 것으로 알려져 있지 않은 컬렉션에 유용합니다. List의 경우, 인덱스 액세스 연산자 (get() 또는 [])를 사용하는 것이 더 관용적입니다.

fun main() {
    val numbers = linkedSetOf("one", "two", "three", "four", "five")
    println(numbers.elementAt(3))    

    val numbersSortedSet = sortedSetOf("one", "two", "three", "four")
    println(numbersSortedSet.elementAt(0)) // elements are stored in the ascending order
}

컬렉션의 첫 번째와 마지막 요소를 검색하는 데 유용한 별칭도 있습니다: first()와 last().

fun main() {
    val numbers = listOf("one", "two", "three", "four", "five")
    println(numbers.first())    
    println(numbers.last())    
}

존재하지 않는 위치의 요소를 검색할 때 예외를 피하려면 elementAt()의 안전한 변형을 사용하세요:

• elementAtOrNull()는 지정된 위치가 컬렉션 경계를 벗어날 경우 null을 반환합니다.
• elementAtOrElse()는 추가적으로 Int 인수를 컬렉션 요소 타입의 인스턴스로 매핑하는 람다 함수를 받습니다. 범위를 벗어난 위치로 호출되면, elementAtOrElse()는 주어진 값에 대한 람다의 결과를 반환합니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four", "five")
    println(numbers.elementAtOrNull(5))
    println(numbers.elementAtOrElse(5) { index -> "The value for index $index is undefined"})
}

조건별 검색

함수 first()와 last()는 주어진 프레디케이트와 일치하는 요소를 컬렉션에서 검색할 수 있도록 합니다. 컬렉션 요소를 테스트하는 프레디케이트와 함께 first()를 호출하면, 프레디케이트가 true를 반환하는 첫 번째 요소를 받게 됩니다. 반대로, 프레디케이트와 함께 last()를 호출하면 일치하는 마지막 요소를 반환합니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four", "five", "six")
    println(numbers.first { it.length > 3 })
    println(numbers.last { it.startsWith("f") })
}

프레디케이트와 일치하는 요소가 없으면 두 함수 모두 예외를 발생시킵니다. 이를 피하려면 firstOrNull() 및 lastOrNull()를 대신 사용하세요: 일치하는 요소가 없으면 null을 반환합니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four", "five", "six")
    println(numbers.firstOrNull { it.length > 6 })
}

이름이 상황에 더 적합하다면 다음 별칭을 사용하세요:

• firstOrNull() 대신 find()
• lastOrNull() 대신 findLast()

fun main() {
    val numbers = listOf(1, 2, 3, 4)
    println(numbers.find { it % 2 == 0 })
    println(numbers.findLast { it % 2 == 0 })
}

셀렉터로 검색

요소를 검색하기 전에 컬렉션을 매핑해야 하는 경우, firstNotNullOf() 함수를 사용할 수 있습니다. 이 함수는 두 가지 작업을 결합합니다:

• 셀렉터 함수로 컬렉션을 매핑합니다.
• 결과에서 첫 번째 null이 아닌 값을 반환합니다.

firstNotNullOf()는 결과 컬렉션에 null이 아닌 요소가 없을 경우 NoSuchElementException을 발생시킵니다. 이 경우 null을 반환하려면 대응하는 firstNotNullOfOrNull()를 사용하세요.

fun main() {
    val list = listOf<Any>(0, "true", false)
    // Converts each element to string and returns the first one that has required length
    val longEnough = list.firstNotNullOf { item -> item.toString().takeIf { it.length >= 4 } }
    println(longEnough)
}

임의 요소

컬렉션의 임의 요소를 검색해야 하는 경우, random() 함수를 호출하세요. 인수 없이 호출하거나, 무작위성(randomness)의 원천으로 Random 객체를 사용하여 호출할 수 있습니다.

fun main() {
    val numbers = listOf(1, 2, 3, 4)
    println(numbers.random())
}

비어 있는 컬렉션에서는 random()이 예외를 발생시킵니다. 대신 null을 받으려면 randomOrNull()을 사용하세요.

요소 존재 여부 확인

컬렉션에 요소의 존재 여부를 확인하려면 contains() 함수를 사용하세요. 이 함수는 함수의 인수가 equals()하는 컬렉션 요소가 있을 경우 true를 반환합니다. in 키워드를 사용하여 contains()를 연산자 형식으로 호출할 수 있습니다.

여러 인스턴스의 존재 여부를 한 번에 확인하려면, 이 인스턴스들의 컬렉션을 인수로 containsAll()를 호출하세요.

fun main() {
    val numbers = listOf("one", "two", "three", "four", "five", "six")
    println(numbers.contains("four"))
    println("zero" in numbers)
    
    println(numbers.containsAll(listOf("four", "two")))
    println(numbers.containsAll(listOf("one", "zero")))
}

또한 isEmpty() 또는 isNotEmpty()를 호출하여 컬렉션에 요소가 포함되어 있는지 확인할 수 있습니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four", "five", "six")
    println(numbers.isEmpty())
    println(numbers.isNotEmpty())
    
    val empty = emptyList<String>()
    println(empty.isEmpty())
    println(empty.isNotEmpty())
}