Skip to content

컬렉션 연산 개요 ​

Kotlin 표준 라이브러리는 컬렉션에 대한 다양한 연산을 수행할 수 있는 광범위한 함수를 제공합니다. 여기에는 요소를 가져오거나 추가하는 간단한 연산뿐만 아니라 검색, 정렬, 필터링, 변환 등과 같은 복잡한 연산도 포함됩니다.

확장 함수 및 멤버 함수 ​

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

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

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

그 외의 컬렉션 연산은 확장 함수로 선언되어 있습니다. 여기에는 필터링, 변환, 순서 지정 및 기타 컬렉션 처리 함수가 포함됩니다.

공통 연산 ​

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

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

kotlin

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()를 사용할 수 있습니다. 이 함수들은 대상 컬렉션을 추가 매개변수로 받습니다.

kotlin

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

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

kotlin

fun main() {
    val numbers = listOf("one", "two", "three", "four")
    // 새 해시 셋으로 바로 필터링하여 
    // 결과에서 중복을 제거함
    val result = numbers.mapTo(HashSet()) { it.length }
    println("distinct item lengths are $result")
}

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

쓰기 연산 ​

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

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

kotlin

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