Функция substring

Функция substring используется для извлечения части строки. Она принимает индексы символов в строке и возвращает новую строку, состоящую из символов в указанном диапазоне.

Синтаксис

kotlinfun String.substring(startIndex: Int): String
kotlinfun String.substring(startIndex: Int, endIndex: Int): String
kotlinfun String.substring(range: IntRange): String

Пример

Извлечем подстроку начиная с индекса 2 до конца строки:

kotlinval str = "abcde"
val res = str.substring(2)
println(res)

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

kotlinString "cde"

Пример

Извлечем подстроку с индекса 1 по индекс 4 (символ с индексом 4 не включается):

kotlinval str = "abcde"
val res = str.substring(1, 4)
println(res)

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

kotlinString "bcd"

Пример

Извлечем подстроку используя диапазон 1..3:

kotlinval str = "abcde"
val res = str.substring(1..3)
println(res)

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

kotlinString "bcd"

Пример

Использование диапазона до конца строки:

kotlinval str = "abcde"
val res = str.substring(2..str.lastIndex)
println(res)

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

kotlinString "cde"

Пример

Если указать неверные индексы, будет выброшено исключение:

kotlinval str = "abcde"

try {
  val res = str.substring(10)
  println(res)
} catch (e: IndexOutOfBoundsException) {
  println("Error: ${e.message}")
}

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

kotlinError: startIndex: 10, endIndex: 5, length: 5

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

  • функцию split,
    которая разделяет строку на части по разделителю
  • функцию replace,
    которая заменяет часть строки на другую подстроку
  • функцию take,
    которая берет первые n символов строки
  • функцию drop,
    которая удаляет первые n символов строки