Skip to content

컬렉션 집계 연산 ​

Kotlin 컬렉션에는 컬렉션의 내용을 기반으로 단일 값을 반환하는 연산인 자주 사용되는 _집계 연산(aggregate operations)_을 위한 함수들이 포함되어 있습니다. 이들 대부분은 잘 알려져 있으며 다른 언어에서 동작하는 방식과 동일합니다.

  • minOrNull()과 maxOrNull()은 각각 가장 작은 요소와 가장 큰 요소를 반환합니다. 빈 컬렉션에서는 null을 반환합니다.
  • average()는 숫자 컬렉션에서 요소들의 평균값을 반환합니다.
  • sum()은 숫자 컬렉션에서 요소들의 합을 반환합니다.
  • count()는 컬렉션의 요소 개수를 반환합니다.
kotlin

fun main() {
    val numbers = listOf(6, 42, 10, 4)

    println("Count: ${numbers.count()}")
    println("Max: ${numbers.maxOrNull()}")
    println("Min: ${numbers.minOrNull()}")
    println("Average: ${numbers.average()}")
    println("Sum: ${numbers.sum()}")
}

또한 특정 선택자 함수(selector function)나 커스텀 Comparator를 기준으로 가장 작은 요소와 가장 큰 요소를 가져오는 함수들도 있습니다.

  • maxByOrNull()과 minByOrNull()은 선택자 함수를 받아, 해당 함수가 가장 크거나 가장 작은 값을 반환하도록 하는 요소를 반환합니다.
  • maxWithOrNull()과 minWithOrNull()은 Comparator 객체를 받아 해당 Comparator에 따라 가장 크거나 가장 작은 요소를 반환합니다.
  • maxOfOrNull()과 minOfOrNull()은 선택자 함수를 받아 선택자 함수 자체의 반환값 중 가장 크거나 가장 작은 값을 반환합니다.
  • maxOfWithOrNull()과 minOfWithOrNull()은 Comparator 객체를 받아 해당 Comparator에 따라 선택자 함수의 반환값 중 가장 크거나 가장 작은 값을 반환합니다.

이 함수들은 빈 컬렉션에 대해 null을 반환합니다. 또한 동일한 동작을 수행하지만 빈 컬렉션에 대해 NoSuchElementException을 발생시키는 대체 함수들인 maxOf, minOf, maxOfWith, minOfWith도 있습니다.

kotlin

fun main() {
    val numbers = listOf(5, 42, 10, 4)
    val min3Remainder = numbers.minByOrNull { it % 3 }
    println(min3Remainder)

    val strings = listOf("one", "two", "three", "four")
    val longestString = strings.maxWithOrNull(compareBy { it.length })
    println(longestString)
}

일반적인 sum() 외에도, 선택자 함수를 인자로 받아 모든 컬렉션 요소에 해당 함수를 적용한 결과의 합을 반환하는 고급 합산 함수인 sumOf()가 있습니다. 선택자 함수는 Int, Long, Double, UInt, ULong(JVM의 경우 BigInteger 및 BigDecimal도 지원)과 같은 다양한 숫자 타입을 반환할 수 있습니다.

kotlin

fun main() {
    val numbers = listOf(5, 42, 10, 4)
    println(numbers.sumOf { it * 2 })
    println(numbers.sumOf { it.toDouble() / 2 })
}

Fold 및 reduce ​

보다 구체적인 상황을 위해 컬렉션 요소에 주어진 연산을 순차적으로 적용하고 누적된 결과를 반환하는 reduce() 및 fold() 함수가 있습니다. 이 연산은 이전에 누적된 값과 컬렉션 요소라는 두 개의 인자를 받습니다.

두 함수의 차이점은 fold()는 초깃값을 받아 첫 번째 단계에서 누적값으로 사용하는 반면, reduce()는 첫 번째 단계에서 첫 번째 요소와 두 번째 요소를 연산의 인자로 사용한다는 것입니다.

kotlin
fun main() {
    val numbers = listOf(5, 2, 10, 4)

    val simpleSum = numbers.reduce { sum, element -> sum + element }
    println(simpleSum)
    val sumDoubled = numbers.fold(0) { sum, element -> sum + element * 2 }
    println(sumDoubled)

    //잘못된 예: 결과에서 첫 번째 요소는 2배가 되지 않음
    //val sumDoubledReduce = numbers.reduce { sum, element -> sum + element * 2 } 
    //println(sumDoubledReduce)
}

위의 예시는 그 차이점을 보여줍니다. fold()는 각 요소를 2배로 만든 값들의 합을 계산하는 데 사용되었습니다. reduce()에 동일한 함수를 전달하면 첫 번째 단계에서 리스트의 첫 번째와 두 번째 요소를 인자로 사용하기 때문에 첫 번째 요소가 2배가 되지 않아 다른 결과를 반환하게 됩니다.

요소에 역순으로 함수를 적용하려면 reduceRight() 및 foldRight() 함수를 사용하세요. 이 함수들은 fold() 및 reduce()와 유사하게 동작하지만 마지막 요소부터 시작하여 이전 요소로 진행합니다. 오른쪽에서부터 fold하거나 reduce할 때는 연산 인자의 순서가 변경된다는 점에 주의하세요. 첫 번째 인자가 요소이고, 두 번째 인자가 누적값입니다.

kotlin

fun main() {
    val numbers = listOf(5, 2, 10, 4)
    val sumDoubledRight = numbers.foldRight(0) { element, sum -> sum + element * 2 }
    println(sumDoubledRight)
}

요소의 인덱스를 매개변수로 받는 연산을 적용할 수도 있습니다. 이를 위해 요소의 인덱스를 연산의 첫 번째 인자로 전달하는 reduceIndexed() 및 foldIndexed() 함수를 사용할 수 있습니다.

마지막으로, 이러한 연산을 컬렉션 요소에 오른쪽에서 왼쪽으로 적용하는 reduceRightIndexed() 및 foldRightIndexed() 함수도 있습니다.

kotlin

fun main() {
    val numbers = listOf(5, 2, 10, 4)
    val sumEven = numbers.foldIndexed(0) { idx, sum, element -> if (idx % 2 == 0) sum + element else sum }
    println(sumEven)

    val sumEvenRight = numbers.foldRightIndexed(0) { idx, element, sum -> if (idx % 2 == 0) sum + element else sum }
    println(sumEvenRight)
}

모든 reduce 연산은 빈 컬렉션에 대해 예외를 발생시킵니다. 대신 null을 반환받으려면 해당하는 *OrNull() 함수를 사용하세요.

중간 누적값을 보존하고 싶은 경우에는 runningFold()(동의어: scan()) 및 runningReduce() 함수를 제공합니다.

kotlin

fun main() {
    val numbers = listOf(0, 1, 2, 3, 4, 5)
    val runningReduceSum = numbers.runningReduce { sum, item -> sum + item }
    val runningFoldSum = numbers.runningFold(10) { sum, item -> sum + item }
    val transform = { index: Int, element: Int -> "N = ${index + 1}: $element" }
    println(runningReduceSum.mapIndexed(transform).joinToString("\n", "Sum of first N elements with runningReduce:\n"))
    println(runningFoldSum.mapIndexed(transform).joinToString("\n", "Sum of first N elements with runningFold:\n"))
}

연산 매개변수에 인덱스가 필요한 경우에는 runningFoldIndexed() 또는 runningReduceIndexed()를 사용하세요.