컬렉션 작업 개요

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

확장 함수와 멤버 함수

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

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

컬렉션 인터페이스의 고유한 구현을 생성할 때 해당 멤버 함수를 구현해야 합니다. 새로운 구현 생성을 더 쉽게 하려면 표준 라이브러리의 스켈레톤(skeletal) 컬렉션 인터페이스 구현인 AbstractCollection, AbstractList, AbstractSet, AbstractMap 및 이들의 가변(mutable) 버전을 사용하세요.

다른 컬렉션 작업은 확장 함수로 선언됩니다. 이들은 필터링, 변환, 순서 지정 및 기타 컬렉션 처리 함수입니다.

일반적인 작업

일반적인 작업은 읽기 전용 컬렉션과 가변(mutable) 컬렉션 모두에서 사용 가능합니다. 일반적인 작업은 다음 그룹으로 분류됩니다.

• 변환
• 필터링
• plus 및 minus 연산자
• 그룹화
• 컬렉션 일부 검색
• 단일 요소 검색
• 순서 지정
• 집계 작업

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

fun main() {
    val numbers = listOf("one", "two", "three", "four")  
    numbers.filter { it.length > 3 }  // nothing happens with `numbers`, result is lost
    println("numbers are still $numbers")
    val longerThan3 = numbers.filter { it.length > 3 } // result is stored in `longerThan3`
    println("numbers longer than 3 chars are $longerThan3")
}

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

fun main() {
    val numbers = listOf("one", "two", "three", "four")
    val filterResults = mutableListOf<String>()  //destination object
    numbers.filterTo(filterResults) { it.length > 3 }
    numbers.filterIndexedTo(filterResults) { index, _ -> index == 0 }
    println(filterResults) // contains results of both operations
}

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

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

대상을 사용하는 함수는 필터링, 연관(association), 그룹화, 평탄화(flattening) 및 기타 작업에 사용 가능합니다. 전체 대상 작업 목록은 코틀린 컬렉션 참조를 확인하세요.

쓰기 작업

가변(mutable) 컬렉션의 경우 컬렉션 상태를 변경하는 _쓰기 작업_도 있습니다. 이러한 작업에는 요소 추가, 제거 및 업데이트가 포함됩니다. 쓰기 작업은 쓰기 작업과 리스트별 작업 및 맵별 작업의 해당 섹션에 나열되어 있습니다.

특정 작업의 경우 동일한 작업을 수행하기 위한 함수 쌍이 있습니다. 하나는 해당 위치에서(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
}