Функция subSequence

Функция subSequence возвращает подпоследовательность символов из текущего StringBuilder. Функция принимает два параметра: startIndex - начальный индекс (включительно) и endIndex - конечный индекс (исключительно). Возвращает объект типа CharSequence.

Синтаксис

kotlinfun subSequence(startIndex: Int, endIndex: Int): CharSequence

Пример

Получим подпоследовательность с 2 по 5 индекс из StringBuilder:

kotlinval sb = StringBuilder("abcde12345")
val res: CharSequence = sb.subSequence(2, 5)
println(res)

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

kotlinCharSequence "cde"

Пример

Получим подпоследовательность с начала строки:

kotlinval sb = StringBuilder("abcde12345")
val res: CharSequence = sb.subSequence(0, 3)
println(res)

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

kotlinCharSequence "abc"

Пример

Получим подпоследовательность до конца строки:

kotlinval sb = StringBuilder("abcde12345")
val res: CharSequence = sb.subSequence(5, sb.length)
println(res)

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

kotlinCharSequence "12345"

Пример

Использование subSequence с пустым StringBuilder:

kotlinval sb = StringBuilder("")
val res: CharSequence = sb.subSequence(0, 0)
println(res)

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

kotlinCharSequence ""

Пример

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

kotlinval sb = StringBuilder("abcde")

try {
  val res = sb.subSequence(3, 10)
  println(res)
} catch (e: StringIndexOutOfBoundsException) {
  println("Error: " + e.message)
}

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

kotlinError: start 3, end 10, length 5

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

  • функцию substring,
    которая возвращает подстроку в виде String
  • функцию append,
    которая добавляет содержимое в StringBuilder
  • функцию insert,
    которая вставляет содержимое в StringBuilder
  • функцию delete,
    которая удаляет символы из StringBuilder