substring
Требования к платформе и версии: Common (1.0)
fun String.substring(range: IntRange): String
Возвращает подстроку, заданную указанным диапазоном индексов.
inline fun CharSequence.substring(startIndex: Int, endIndex: Int = length): String
Возвращает подстроку символов из диапазона этой последовательности символов, начиная с startIndex и заканчивая непосредственно перед endIndex.
Параметры
начальный индекс (включительно).
конечный индекс (исключительно). Если не указан, используется длина последовательности символов.
fun CharSequence.substring(range: IntRange): String
Возвращает подстроку символов с индексами из указанного диапазона этой последовательности символов.
expect fun String.substring(startIndex: Int): String
Возвращает подстроку этой строки, которая начинается с указанного startIndex и продолжается до конца строки.
Параметры
начальный индекс (включительно).
Выбрасывает исключение
если startIndex отрицательный или превышает длину строки.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val str = "abcde"
println(str.substring(0)) // abcde
println(str.substring(1)) // bcde
// startIndex exceeds the string length
// str.substring(6) // will fail with IndexOutOfBoundsException
//sampleEnd
}expect fun String.substring(startIndex: Int, endIndex: Int): String
Возвращает подстроку этой строки, начиная с startIndex и заканчивая непосредственно перед endIndex.
Параметры
начальный индекс (включительно).
конечный индекс (исключительно).
Выбрасывает исключение
если startIndex отрицательный, endIndex превышает длину строки или startIndex больше endIndex.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val str = "abcde"
println(str.substring(0, 0)) //
println(str.substring(0, 1)) // a
println(str.substring(5, 5)) //
// endIndex exceeds string length
// str.substring(0, 6) // will fail with IndexOutOfBoundsException
// endIndex is smaller than the startIndex
// str.substring(1, 0) // will fail with IndexOutOfBoundsException
//sampleEnd
}Требования к платформе и версии: JS (1.1), Wasm-JS (1.8), Wasm-WASI (1.8)
actual fun String.substring(startIndex: Int): String
Возвращает подстроку этой строки, которая начинается с указанного startIndex и продолжается до конца строки.
Параметры
начальный индекс (включительно).
Выбрасывает исключение
если startIndex отрицательный или превышает длину строки.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val str = "abcde"
println(str.substring(0)) // abcde
println(str.substring(1)) // bcde
// startIndex exceeds the string length
// str.substring(6) // will fail with IndexOutOfBoundsException
//sampleEnd
}actual fun String.substring(startIndex: Int, endIndex: Int): String
Возвращает подстроку этой строки, начиная с startIndex и заканчивая непосредственно перед endIndex.
Параметры
начальный индекс (включительно).
конечный индекс (исключительно).
Выбрасывает исключение
если startIndex отрицательный, endIndex превышает длину строки или startIndex больше endIndex.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val str = "abcde"
println(str.substring(0, 0)) //
println(str.substring(0, 1)) // a
println(str.substring(5, 5)) //
// endIndex exceeds string length
// str.substring(0, 6) // will fail with IndexOutOfBoundsException
// endIndex is smaller than the startIndex
// str.substring(1, 0) // will fail with IndexOutOfBoundsException
//sampleEnd
}Требования к платформе и версии: JVM (1.0), Native (1.3)
actual inline fun String.substring(startIndex: Int): String
Возвращает подстроку этой строки, которая начинается с указанного startIndex и продолжается до конца строки.
Параметры
начальный индекс (включительно).
Выбрасывает исключение
если startIndex отрицательный или превышает длину строки.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val str = "abcde"
println(str.substring(0)) // abcde
println(str.substring(1)) // bcde
// startIndex exceeds the string length
// str.substring(6) // will fail with IndexOutOfBoundsException
//sampleEnd
}actual inline fun String.substring(startIndex: Int, endIndex: Int): String
Возвращает подстроку этой строки, начиная с startIndex и заканчивая непосредственно перед endIndex.
Параметры
начальный индекс (включительно).
конечный индекс (исключительно).
Выбрасывает исключение
если startIndex отрицательный, endIndex превышает длину строки или startIndex больше endIndex.
Примеры
import kotlin.test.*
fun main() {
//sampleStart
val str = "abcde"
println(str.substring(0, 0)) //
println(str.substring(0, 1)) // a
println(str.substring(5, 5)) //
// endIndex exceeds string length
// str.substring(0, 6) // will fail with IndexOutOfBoundsException
// endIndex is smaller than the startIndex
// str.substring(1, 0) // 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.text/substring.html
