Spec-Zone.ru › Kotlin 2

subList

kotlin-stdlib/kotlin.collections/AbstractMutableList/subList

Платформы и требования к версии: Common (1.0), JS (1.1)

expect open override fun subList(fromIndex: Int, toIndex: Int): MutableList<E>

Возвращает представление части этого списка между указанными значениями fromIndex (включительно) и toIndex (не включительно). Возвращённый список связан с исходным, поэтому изменения в возвращённом списке отражаются в исходном, и наоборот.

Структурные изменения исходного списка приводят к неопределённому поведению представления.

Исключения

IndexOutOfBoundsException

если fromIndex меньше нуля или toIndex больше size этого списка.

IllegalArgumentException

если fromIndex больше toIndex.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3, 4, 5)
println(list.subList(2, 4)) // [3, 4]

val mutableList = mutableListOf(1, 2, 3, 4, 5)
val subList = mutableList.subList(2, 4)
println(subList) // [3, 4]

mutableList[3] = -1
println(subList) // [3, -1]

// list.subList(0, 100) // will fail with IndexOutOfBoundsException 
   //sampleEnd
}

Платформы и требования к версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual open override fun subList(fromIndex: Int, toIndex: Int): MutableList<E>

Возвращает представление части этого списка между указанными значениями fromIndex (включительно) и toIndex (не включительно). Возвращённый список связан с исходным, поэтому изменения в возвращённом списке отражаются в исходном, и наоборот.

Структурные изменения исходного списка приводят к неопределённому поведению представления.

Исключения

IndexOutOfBoundsException

если fromIndex меньше нуля или toIndex больше size этого списка.

IllegalArgumentException

если fromIndex больше toIndex.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = listOf(1, 2, 3, 4, 5)
println(list.subList(2, 4)) // [3, 4]

val mutableList = mutableListOf(1, 2, 3, 4, 5)
val subList = mutableList.subList(2, 4)
println(subList) // [3, 4]

mutableList[3] = -1
println(subList) // [3, -1]

// list.subList(0, 100) // will fail with IndexOutOfBoundsException 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-abstract-mutable-list/sub-list.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API