subList

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

expect abstract fun subList(fromIndex: Int, toIndex: Int): List<E>

Возвращает представление части этого списка между указанными индексами 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
}

Требования к платформе и версии: JS (1.1)

actual abstract fun subList(fromIndex: Int, toIndex: Int): List<E>

Возвращает представление части этого списка между указанными индексами 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
}

Требования к платформе и версии: JVM (1.0)

actual abstract fun subList(fromIndex: Int, toIndex: Int): List<E>

Возвращает представление части этого списка между указанными индексами 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
}