개별 요소 추출

코틀린 컬렉션은 컬렉션에서 개별 요소를 추출하기 위한 일련의 함수를 제공합니다. 이 페이지에서 설명하는 함수는 리스트(list)와 셋(set) 모두에 적용됩니다.

리스트의 정의에 따르면 리스트는 순서가 있는(ordered) 컬렉션입니다. 따라서 리스트의 모든 요소는 참조에 사용할 수 있는 고유한 위치를 가집니다. 이 페이지에서 설명하는 함수 외에도, 리스트는 인덱스를 사용하여 요소를 추출하고 검색하는 더 다양한 방법을 제공합니다. 자세한 내용은 리스트 전용 연산을 참고하세요.

반면, 정의상 셋은 순서가 없는 컬렉션입니다. 하지만 코틀린의 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)) // 요소들이 오름차순으로 저장됨
}

컬렉션의 첫 번째와 마지막 요소를 추출하기 위한 유용한 별칭들도 있습니다: 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() 함수를 사용하면 주어진 서술어(predicate)와 일치하는 요소를 컬렉션에서 검색할 수도 있습니다. 컬렉션 요소를 검사하는 서술어와 함께 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() 함수가 있습니다. 이 함수는 다음 두 가지 작업을 결합합니다.

• 선택자(selector) 함수로 컬렉션을 매핑합니다.
• 결과에서 null이 아닌 첫 번째 값을 반환합니다.

firstNotNullOf()는 결과 컬렉션에 null이 아닌 요소가 없으면 NoSuchElementException을 던집니다. 이런 경우 null을 반환하려면 대응하는 함수인 firstNotNullOfOrNull()을 사용하세요.

fun main() {
    val list = listOf<Any>(0, "true", false)
    // 각 요소를 문자열로 변환하고 필요한 길이를 가진 첫 번째 요소를 반환함
    val longEnough = list.firstNotNullOf { item -> item.toString().takeIf { it.length >= 4 } }
    println(longEnough)
}

무작위 요소

컬렉션의 임의의 요소를 추출해야 한다면 random() 함수를 호출하세요. 인자 없이 호출하거나 난수 생성 소스로 Random 객체를 전달하여 호출할 수 있습니다.

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

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

요소 존재 여부 확인

컬렉션에 특정 요소가 포함되어 있는지 확인하려면 contains() 함수를 사용하세요. 함수 인자와 equals() 결과가 같은 컬렉션 요소가 있으면 true를 반환합니다. contains()는 in 키워드를 사용하여 연산자 형태로 호출할 수 있습니다.

여러 인스턴스가 동시에 존재하는지 한 번에 확인하려면 해당 인스턴스들의 컬렉션을 인자로 하여 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())
}