startsWith

Требования к платформе и версии: Common (1.0)

fun CharSequence.startsWith(char: Char, ignoreCase: Boolean = false): Boolean

Возвращает true, если эта последовательность символов начинается с указанного символа.

fun CharSequence.startsWith(prefix: CharSequence, ignoreCase: Boolean = false): Boolean

Возвращает true, если эта последовательность символов начинается с указанного префикса.

fun CharSequence.startsWith(prefix: CharSequence, startIndex: Int, ignoreCase: Boolean = false): Boolean

Возвращает true, если подстрока этой последовательности символов, начинающаяся с указанного смещения startIndex, начинается с указанного префикса.

expect fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean

Возвращает true, если эта строка начинается с указанного префикса.

Параметры

prefix

префикс, с которого должна начинаться эта строка.

ignoreCase

флаг, указывающий, следует ли сравнивать символы строки с символами prefix без учета регистра; по умолчанию сравнение выполняется с учетом регистра.

Примеры

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\") is ${str.startsWith("abc")}") // true
println("str.startsWith(\"ABC\") is ${str.startsWith("ABC")}") // false
println("str.startsWith(\"bcd\") is ${str.startsWith("bcd")}") // false
println("str.startsWith(\"abcdef\") is ${str.startsWith("abcdef")}") // false 
   //sampleEnd
}

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\", ignoreCase = true) is ${str.startsWith("abc", ignoreCase = true)}") // true
println("str.startsWith(\"ABC\", ignoreCase = true) is ${str.startsWith("ABC", ignoreCase = true)}") // true
println("str.startsWith(\"bcd\", ignoreCase = true) is ${str.startsWith("bcd", ignoreCase = true)}") // false 
   //sampleEnd
}

expect fun String.startsWith(prefix: String, startIndex: Int, ignoreCase: Boolean = false): Boolean

Возвращает true, если подстрока этой строки, начинающаяся с указанного смещения startIndex, начинается с указанного префикса.

Параметры

prefix

префикс, с которого должна начинаться подстрока этой строки, начинающаяся с startIndex.

startIndex

начальный индекс (включительно).

ignoreCase

Примеры

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\", startIndex = 1) is ${str.startsWith("abc", startIndex = 1)}") // false
println("str.startsWith(\"BCD\", startIndex = 1) is ${str.startsWith("BCD", startIndex = 1)}") // false
println("str.startsWith(\"bcd\", startIndex = 1) is ${str.startsWith("bcd", startIndex = 1)}") // true 
   //sampleEnd
}

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\", startIndex = 1, ignoreCase = true) is ${str.startsWith("abc", startIndex = 1, ignoreCase = true)}") // false
println("str.startsWith(\"bcd\", startIndex = 1, ignoreCase = true) is ${str.startsWith("bcd", startIndex = 1, ignoreCase = true)}") // true
println("str.startsWith(\"BCD\", startIndex = 1, ignoreCase = true) is ${str.startsWith("BCD", startIndex = 1, ignoreCase = true)}") // true 
   //sampleEnd
}

Требования к платформе и версии: JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean

Возвращает true, если эта строка начинается с указанного префикса.

Параметры

prefix

префикс, с которого должна начинаться эта строка.

ignoreCase

Примеры

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\") is ${str.startsWith("abc")}") // true
println("str.startsWith(\"ABC\") is ${str.startsWith("ABC")}") // false
println("str.startsWith(\"bcd\") is ${str.startsWith("bcd")}") // false
println("str.startsWith(\"abcdef\") is ${str.startsWith("abcdef")}") // false 
   //sampleEnd
}

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\", ignoreCase = true) is ${str.startsWith("abc", ignoreCase = true)}") // true
println("str.startsWith(\"ABC\", ignoreCase = true) is ${str.startsWith("ABC", ignoreCase = true)}") // true
println("str.startsWith(\"bcd\", ignoreCase = true) is ${str.startsWith("bcd", ignoreCase = true)}") // false 
   //sampleEnd
}

actual fun String.startsWith(prefix: String, startIndex: Int, ignoreCase: Boolean = false): Boolean

Параметры

prefix

префикс, с которого должна начинаться подстрока этой строки, начинающаяся с startIndex.

startIndex

начальный индекс (включительно).

ignoreCase

Исключения

IndexOutOfBoundsException

если startIndex отрицателен или превышает длину строки.

Примеры

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\", startIndex = 1) is ${str.startsWith("abc", startIndex = 1)}") // false
println("str.startsWith(\"BCD\", startIndex = 1) is ${str.startsWith("BCD", startIndex = 1)}") // false
println("str.startsWith(\"bcd\", startIndex = 1) is ${str.startsWith("bcd", startIndex = 1)}") // true 
   //sampleEnd
}

import kotlin.test.*

fun main() { 
   //sampleStart 
   val str = "abcde"
println("str.startsWith(\"abc\", startIndex = 1, ignoreCase = true) is ${str.startsWith("abc", startIndex = 1, ignoreCase = true)}") // false
println("str.startsWith(\"bcd\", startIndex = 1, ignoreCase = true) is ${str.startsWith("bcd", startIndex = 1, ignoreCase = true)}") // true
println("str.startsWith(\"BCD\", startIndex = 1, ignoreCase = true) is ${str.startsWith("BCD", startIndex = 1, ignoreCase = true)}") // true 
   //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/starts-with.html