단일 요소 추출
Kotlin 컬렉션은 컬렉션에서 단일 요소를 추출하기 위한 다양한 함수를 제공합니다. 이 페이지에서 설명하는 함수들은 리스트(list)와 세트(set) 모두에 적용됩니다.
리스트의 정의에서 알 수 있듯이, 리스트는 순서가 있는 컬렉션(ordered collection)입니다. 따라서 리스트의 모든 요소는 참조에 사용할 수 있는 고유한 위치(position)를 가집니다. 이 페이지에 설명된 함수 외에도 리스트는 인덱스를 통해 요소를 추출하고 검색할 수 있는 더 다양한 방법을 제공합니다. 자세한 내용은 List 전용 연산을 참조하세요.
반면, 세트는 정의상 순서가 없는 컬렉션입니다. 하지만 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)) // 요소가 오름차순으로 저장됨
}컬렉션의 첫 번째와 마지막 요소를 가져오기 위한 유용한 별칭(alias) 함수도 있습니다: 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())
}