Функция first

Функция first возвращает первый символ строки. Если строка пустая, функция выбросит исключение NoSuchElementException. Также функция может принимать условие в виде предиката для поиска первого элемента, удовлетворяющего условию.

Синтаксис

kotlinfun CharSequence.first(): Char
kotlinfun CharSequence.first(predicate: (Char) -> Boolean): Char

Пример

Получим первый символ строки "abcde":

kotlinval str = "abcde"
val res = str.first()
println(res)

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

kotlinChar 'a'

Пример

Попробуем получить первый символ пустой строки:

kotlinval str = ""
val res = str.first()
println(res)

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

kotlinException: NoSuchElementException

Пример

Найдем первый символ в строке, который является цифрой:

kotlinval str = "hello123world"
val res = str.first { it.isDigit() }
println(res)

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

kotlinChar '1'

Пример

Найдем первый заглавный символ в строке:

kotlinval str = "hello World"
val res = str.first { it.isUpperCase() }
println(res)

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

kotlinChar 'W'

Пример

Попробуем найти символ, которого нет в строке:

kotlinval str = "abcde"
val res = str.first { it == 'z' }
println(res)

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

kotlinException: NoSuchElementException

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

  • функцию last,
    которая возвращает последний символ строки
  • функцию take,
    которая возвращает первые n символов строки
  • функцию drop,
    которая возвращает строку без первых n символов
  • функцию indexOf,
    которая возвращает индекс первого вхождения символа