컬렉션 연산 개요

코틀린 표준 라이브러리는 컬렉션에서 연산을 수행하기 위한 매우 다양한 함수를 제공합니다. 여기에는 요소 가져오기 또는 추가와 같은 단순한 연산부터 검색, 정렬, 필터링, 변환(transformations) 등과 같은 복잡한 연산까지 포함됩니다.

확장 함수 및 멤버 함수

컬렉션 연산은 표준 라이브러리에서 두 가지 방식으로 선언됩니다: 컬렉션 인터페이스의 멤버 함수와 확장 함수입니다.

멤버 함수는 컬렉션 타입에 필수적인 연산을 정의합니다. 예를 들어, Collection은 비어 있는지 확인하기 위한 isEmpty() 함수를 포함하고, List는 인덱스로 요소에 접근하기 위한 get() 등을 포함합니다.

컬렉션 인터페이스를 직접 구현할 때는 해당 멤버 함수들을 반드시 구현해야 합니다. 새로운 구현체를 더 쉽게 만들 수 있도록 표준 라이브러리에서 제공하는 컬렉션 인터페이스의 골격 구현(skeletal implementations)인 AbstractCollection, AbstractList, AbstractSet, AbstractMap 및 이들의 가변(mutable) 대응 클래스들을 사용하세요.

그 외의 컬렉션 연산들은 확장 함수로 선언되어 있습니다. 필터링, 변환, 정렬 및 기타 컬렉션 처리 함수들이 이에 해당합니다.

공통 연산

공통 연산은 읽기 전용 및 가변 컬렉션 모두에서 사용할 수 있습니다. 공통 연산은 다음과 같은 그룹으로 나뉩니다:

• 변환(Transformations)
• 필터링(Filtering)
• plus 및 minus 연산자
• 그룹화(Grouping)
• 컬렉션 일부 추출(Retrieving collection parts)
• 단일 요소 추출(Retrieving single elements)
• 정렬(Ordering)
• 집계 연산(Aggregate operations)

이 페이지들에서 설명하는 연산은 원본 컬렉션에 영향을 주지 않고 결과를 반환합니다. 예를 들어, 필터링 연산은 필터 조건(predicate)과 일치하는 모든 요소를 포함하는 _새로운 컬렉션_을 생성합니다. 이러한 연산의 결과는 변수에 저장하거나 다른 함수에 전달하는 등의 방식으로 사용해야 합니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four")  
    numbers.filter { it.length > 3 }  // numbers에는 아무런 변화가 없으며, 결과가 유실됩니다.
    println("numbers are still $numbers")
    val longerThan3 = numbers.filter { it.length > 3 } // 결과가 longerThan3에 저장됩니다.
    println("numbers longer than 3 chars are $longerThan3")
}

특정 컬렉션 연산의 경우, 대상(destination) 객체를 지정할 수 있는 옵션이 있습니다. 대상은 함수가 결과를 새로운 객체로 반환하는 대신 결과 항목을 추가할 가변 컬렉션입니다. 대상과 함께 연산을 수행하기 위해 이름에 To 접미사가 붙은 별도의 함수들이 있습니다. 예를 들어, filter() 대신 filterTo()를, associate() 대신 associateTo()를 사용합니다. 이 함수들은 대상 컬렉션을 추가 파라미터로 받습니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four")
    val filterResults = mutableListOf<String>()  // 대상 객체
    numbers.filterTo(filterResults) { it.length > 3 }
    numbers.filterIndexedTo(filterResults) { index, _ -> index == 0 }
    println(filterResults) // 두 연산의 결과가 모두 포함됨
}

편의를 위해 이 함수들은 대상 컬렉션을 다시 반환하므로, 함수 호출의 해당 인자에서 바로 생성할 수 있습니다.

fun main() {
    val numbers = listOf("one", "two", "three", "four")
    // 숫자를 새로운 hash set으로 바로 필터링하여,
    // 결과에서 중복을 제거합니다.
    val result = numbers.mapTo(HashSet()) { it.length }
    println("distinct item lengths are $result")
}

대상(destination)을 사용하는 함수는 필터링, 연관(association), 그룹화, 평탄화(flattening) 및 기타 연산에서 사용할 수 있습니다. 대상 연산의 전체 목록은 Kotlin 컬렉션 레퍼런스를 참조하세요.

쓰기 연산

가변 컬렉션에는 컬렉션 상태를 변경하는 _쓰기 연산(write operations)_도 있습니다. 이러한 연산에는 요소 추가, 삭제 및 업데이트가 포함됩니다. 쓰기 연산은 쓰기 연산 섹션과 List 전용 연산 및 Map 전용 연산의 해당 섹션에 나열되어 있습니다.

특정 연산의 경우 동일한 연산을 수행하는 함수 쌍이 존재합니다. 하나는 연산을 제자리(in-place)에서 적용하고, 다른 하나는 결과를 별도의 컬렉션으로 반환합니다. 예를 들어, sort()는 가변 컬렉션을 제자리에서 정렬하여 상태를 변경하고, sorted()는 동일한 요소를 정렬된 순서로 포함하는 새로운 컬렉션을 생성합니다.

fun main() {
    val numbers = mutableListOf("one", "two", "three", "four")
    val sortedNumbers = numbers.sorted()
    println(numbers == sortedNumbers)  // false
    numbers.sort()
    println(numbers == sortedNumbers)  // true
}