trimToSize

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

expect fun trimToSize()

Пытается сократить объём памяти, используемой этим списком.

Если ёмкость внутреннего хранилища этого списка превышает необходимую для хранения текущих элементов, она может быть уменьшена для более эффективного использования памяти. Эта операция помогает сократить потребление памяти, если список не предполагается в дальнейшем увеличивать.

На целевой платформе JS этот метод не оказывает никакого эффекта из-за особенностей внутренней реализации JS.

Примеры

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

fun main() { 
   //sampleStart 
   val list = ArrayList<Int>(1000)
// Add only a few elements
list.addAll(listOf(1, 2, 3))
println(list) // [1, 2, 3]

// The list has capacity for 1000 elements, but only 3 are used.
// trimToSize() can help reduce memory usage by resizing the backing storage
// to fit the actual number of elements.
list.trimToSize()

// The list content remains the same
println(list) // [1, 2, 3]
println(list.size) // 3 
   //sampleEnd
}

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

actual fun trimToSize()

Ничего не делает в этой реализации ArrayList.

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

actual fun trimToSize()

Пытается сократить объём памяти, используемой этим списком.

Если ёмкость внутреннего хранилища этого списка превышает необходимую для хранения текущих элементов, она может быть уменьшена для более эффективного использования памяти. Эта операция помогает сократить потребление памяти, если список не предполагается в дальнейшем увеличивать.

Примеры

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

fun main() { 
   //sampleStart 
   val list = ArrayList<Int>(1000)
// Add only a few elements
list.addAll(listOf(1, 2, 3))
println(list) // [1, 2, 3]

// The list has capacity for 1000 elements, but only 3 are used.
// trimToSize() can help reduce memory usage by resizing the backing storage
// to fit the actual number of elements.
list.trimToSize()

// The list content remains the same
println(list) // [1, 2, 3]
println(list.size) // 3 
   //sampleEnd
}