Функция substring

Функция substring возвращает подстроку из текущего StringBuilder. Может принимать один параметр - начальный индекс, или два параметра - начальный и конечный индекс. При этом подстрока включает символ по начальному индексу и исключает символ по конечному индексу.

Синтаксис

fun substring(startIndex: Int): String

fun substring(startIndex: Int, endIndex: Int): String

Пример

Получим подстроку с 3-го индекса до конца:

val sb = StringBuilder("abcde")
val res: String = sb.substring(3)
println(res)

Результат выполнения кода:

String "de"

Пример

Получим подстроку с 1-го по 4-й индекс:

val sb = StringBuilder("abcde")
val res: String = sb.substring(1, 4)
println(res)

Результат выполнения кода:

String "bcd"

Пример

Если начальный индекс равен конечному, возвращается пустая строка:

val sb = StringBuilder("abcde")
val res: String = sb.substring(2, 2)
println(res)

Результат выполнения кода:

String ""

Пример

Использование substring с числовым содержимым:

val sb = StringBuilder("12345")
val res: String = sb.substring(1, 4)
println(res)

Результат выполнения кода:

String "234"

Ошибки

При некорректных индексах возникают исключения:

val sb = StringBuilder("abcde")

// IndexOutOfBoundsException - начальный индекс отрицательный
val res1 = sb.substring(-1)

val sb = StringBuilder("abcde")

// IndexOutOfBoundsException - начальный индекс больше длины
val res2 = sb.substring(10)

val sb = StringBuilder("abcde")

// IndexOutOfBoundsException - конечный индекс больше длины
val res3 = sb.substring(1, 10)

val sb = StringBuilder("abcde")

// IndexOutOfBoundsException - начальный индекс больше конечного
val res4 = sb.substring(3, 1)

Смотрите также

функцию subSequence,
которая возвращает подпоследовательность в виде CharSequence
функцию delete,
которая удаляет часть символов из StringBuilder
функцию replace,
которая заменяет часть символов в StringBuilder
функцию insert,
которая вставляет строку в указанную позицию