Spec-Zone.ru › Kotlin 2

setLength

kotlin-stdlib/kotlin.text/StringBuilder/setLength

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

expect fun setLength(newLength: Int)

Устанавливает длину этой строки-сборщика в указанное значение newLength.

Если значение newLength меньше текущей длины, длина изменяется на указанное значение newLength. В противном случае к этой строке-сборщику добавляются нулевые символы '\u0000', пока её длина не станет меньше newLength.

Обратите внимание, что в Kotlin/JS операторная функция set имеет непостоянную вычислительную сложность. Поэтому увеличение длины этой строки-сборщика с последующим обновлением каждого символа по индексу может замедлить работу программы.

Вызывает исключение

IndexOutOfBoundsException

или IllegalArgumentException, если значение newLength меньше нуля.

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

actual fun setLength(newLength: Int)

Устанавливает длину этой строки-сборщика в указанное значение newLength.

Если значение newLength меньше текущей длины, длина изменяется на указанное значение newLength. В противном случае к этой строке-сборщику добавляются нулевые символы '\u0000', пока её длина не станет меньше newLength.

Обратите внимание, что в Kotlin/JS операторная функция set имеет непостоянную вычислительную сложность. Поэтому увеличение длины этой строки-сборщика с последующим обновлением каждого символа по индексу может замедлить работу программы.

Вызывает исключение

IndexOutOfBoundsException

или IllegalArgumentException, если значение newLength меньше нуля.

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

actual fun setLength(newLength: Int)

Устанавливает длину этой строки-сборщика в указанное значение newLength.

Если значение newLength меньше текущей длины, длина изменяется на указанное значение newLength. В противном случае к этой строке-сборщику добавляются нулевые символы '\u0000', пока её длина не станет меньше newLength.

Обратите внимание, что в Kotlin/JS и Kotlin/WasmJs операторная функция set имеет непостоянную вычислительную сложность. Поэтому увеличение длины этой строки-сборщика с последующим обновлением каждого символа по индексу может замедлить работу программы.

Вызывает исключение

IndexOutOfBoundsException

или IllegalArgumentException, если значение newLength меньше нуля.

© 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.text/-string-builder/set-length.html

Spec-Zone.ru

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