set Length
Требования к платформе и версии: Common (1.4)
expect fun setLength(newLength: Int)
Устанавливает длину этой строки-сборщика в указанное значение newLength.
Если значение newLength меньше текущей длины, длина изменяется на указанное значение newLength. В противном случае к этой строке-сборщику добавляются нулевые символы '\u0000', пока её длина не станет меньше newLength.
Обратите внимание, что в Kotlin/JS операторная функция set имеет непостоянную вычислительную сложность. Поэтому увеличение длины этой строки-сборщика с последующим обновлением каждого символа по индексу может замедлить работу программы.
Вызывает исключение
или 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 имеет непостоянную вычислительную сложность. Поэтому увеличение длины этой строки-сборщика с последующим обновлением каждого символа по индексу может замедлить работу программы.
Вызывает исключение
или IllegalArgumentException, если значение newLength меньше нуля.
Требования к платформе и версии: Wasm-JS (1.8)
actual fun setLength(newLength: Int)
Устанавливает длину этой строки-сборщика в указанное значение newLength.
Если значение newLength меньше текущей длины, длина изменяется на указанное значение newLength. В противном случае к этой строке-сборщику добавляются нулевые символы '\u0000', пока её длина не станет меньше newLength.
Обратите внимание, что в Kotlin/JS и Kotlin/WasmJs операторная функция set имеет непостоянную вычислительную сложность. Поэтому увеличение длины этой строки-сборщика с последующим обновлением каждого символа по индексу может замедлить работу программы.
Вызывает исключение
или 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