Example:
String1 = "AbBaCca";
String2 = "bac";
I want to perform a check that String1 contains String2 or not.
asked Jul 9, 2018 at 5:00
Kotlin has stdlib
package to perform certain extension function operation over the string, you can check this method it will check the substring in a string, you can ignore the case by passing true/false value. Refer this link
"AbBaCca".contains("bac", ignoreCase = true)
zsmb13
84.6k10 gold badges220 silver badges225 bronze badges
answered Jul 9, 2018 at 5:08
Aseem SharmaAseem Sharma
1,65312 silver badges19 bronze badges
The most idiomatic way to check this is to use the in
operator:
String2 in String1
This is equivalent to calling contains()
, but shorter and more readable.
answered Jul 9, 2018 at 6:25
yoleyole
92k20 gold badges259 silver badges197 bronze badges
3
You can do it by using the «in» — operator, e.g.
val url : String = "http://www.google.de"
val check : Boolean = "http" in url
check has the value true then.
answered Jun 15, 2021 at 11:39
IskandirIskandir
8661 gold badge9 silver badges20 bronze badges
1
See the contains
method in the documentation.
String1.contains(String2);
answered Jul 9, 2018 at 5:05
geco17geco17
5,1223 gold badges21 silver badges38 bronze badges
Kotlin has a few different contains function on Strings, see here: https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/contains.html.
If you want it to be true that string2 is contained in string1 (ie you want to ignore case), they even have a convenient boolean argument for you, so you won’t need to convert to lowercase first.
answered Jul 9, 2018 at 5:05
htuy42htuy42
3073 silver badges10 bronze badges
For anyone out there like me who wanted to do this for a nullable String, that is, String?, here is my solution:
operator fun String?.contains(substring:String): Boolean {
return if (this is String) {
// Need to convert to CharSequence, otherwise keeps calling my
// contains in an endless loop.
val charSequence: CharSequence = this
charSequence.contains(substring)
} else {
false
}
}
// Uses Kotlin convention of converting 'in' to operator 'contains'
if (shortString in nullableLongString) {
// TODO: Your stuff goes here!
}
answered Dec 31, 2021 at 0:28
codingjeremycodingjeremy
5,0871 gold badge35 silver badges38 bronze badges
В этой статье рассматриваются различные способы проверки того, содержит ли строка подстроку в Kotlin.
1. Использование contains()
функция
Стандартное решение для проверки того, содержит ли строка указанную последовательность символов в качестве подстроки, заключается в следующем: contains()
функция. Вот пример его использования:
fun main() { val s1 = «Kotlin» val s2 = «in» println(s1.contains(s2)) // true } |
Скачать код
Если вам нужно выполнить сравнение с игнорированием регистра, вы можете передать логическое значение true
в качестве второго параметра contains()
функция.
fun main() { val s1 = «Kotlin» val s2 = «IN» println(s1.contains(s2, ignoreCase = true)) // true } |
Скачать код
2. Использование In
оператор
Способ Kotlin проверить, содержит ли строка подстроку, с помощью In
оператор, который обеспечивает более короткий и читаемый синтаксис. Выражение a in b
переводится на b.contains(a)
и выражение a !in b
переводится на !b.contains(a)
. Другими словами, In
эквивалентно вызову contains()
функция.
fun main() { val s1 = «Kotlin» val s2 = «in» println(s2 in s1) // true } |
Скачать код
Это все, что касается определения того, содержит ли строка подстроку в Kotlin.
Спасибо за чтение.
Пожалуйста, используйте наш онлайн-компилятор размещать код в комментариях, используя C, C++, Java, Python, JavaScript, C#, PHP и многие другие популярные языки программирования.
Как мы? Порекомендуйте нас своим друзьям и помогите нам расти. Удачного кодирования
Функции для работы с текстом и регулярными выражениями.
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
all
Возвращает true
если все символы соответствуют заданному предикату .
fun CharSequence.all(predicate: (Char) -> Boolean): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
any
Возвращает true
если последовательность символов содержит хотя бы один символ.
fun CharSequence.any(): Boolean
Возвращает true
если хотя бы один символ соответствует заданному предикату .
fun CharSequence.any(predicate: (Char) -> Boolean): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
append
Добавляет все аргументы к данному Appendable .
fun <T : Appendable> T.append(vararg value: CharSequence?): T
fun StringBuilder.append(obj: Any?): StringBuilder
Применяет все аргументы к данному StringBuilder.
fun StringBuilder.append(
vararg value: String?
): StringBuilder
fun StringBuilder.append(vararg value: Any?): StringBuilder
appendLine
Добавляет символ перевода строки ( n
) к этому добавляемому объекту.
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun Appendable.appendLine(): Appendable
Добавляет значение к данному Appendable и символ перевода строки ( n
) после него.
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun Appendable.appendLine(value: CharSequence?): Appendable
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun Appendable.appendLine(value: Char): Appendable
Добавляет символ перевода строки ( n
) к этому StringBuilder.
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(): StringBuilder
Добавляет значение к этому StringBuilder , за которым следует символ перевода строки ( n
).
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(
value: CharSequence?
): StringBuilder
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(value: String?): StringBuilder
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(value: Any?): StringBuilder
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(value: CharArray): StringBuilder
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(value: Char): StringBuilder
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun StringBuilder.appendLine(value: Boolean): StringBuilder
Требования к платформе и версии: Собственная (1.4)
fun StringBuilder.appendLine(value: Byte): StringBuilder
Требования к платформе и версии: Собственная (1.4)
fun StringBuilder.appendLine(value: Short): StringBuilder
Требования к платформе и версии: Собственная (1.4)
fun StringBuilder.appendLine(value: Int): StringBuilder
Требования к платформе и версии: Собственная (1.4)
fun StringBuilder.appendLine(value: Long): StringBuilder
Требования к платформе и версии: Собственная (1.4)
fun StringBuilder.appendLine(value: Float): StringBuilder
Требования к платформе и версии: Собственная (1.4)
fun StringBuilder.appendLine(value: Double): StringBuilder
Требования к платформе и версии: Собственная (1.3)
appendln
fun StringBuilder.appendln(it: String): StringBuilder
fun StringBuilder.appendln(it: Boolean): StringBuilder
fun StringBuilder.appendln(it: Byte): StringBuilder
fun StringBuilder.appendln(it: Short): StringBuilder
fun StringBuilder.appendln(it: Int): StringBuilder
fun StringBuilder.appendln(it: Long): StringBuilder
fun StringBuilder.appendln(it: Float): StringBuilder
fun StringBuilder.appendln(it: Double): StringBuilder
fun StringBuilder.appendln(it: Any?): StringBuilder
fun StringBuilder.appendln(): StringBuilder
appendRange
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
Добавляет подпоследовательность указанного значения последовательности символов в этот объект Appendable и возвращает этот экземпляр.
fun <T : Appendable> T.appendRange(
value: CharSequence,
startIndex: Int,
endIndex: Int
): T
Требования к платформе и версии: JS (1.4)
Добавляет символы в подмассиве указанного значения массива символов к этому построителю строк и возвращает этот экземпляр.
fun StringBuilder.appendRange(
value: CharArray,
startIndex: Int,
endIndex: Int
): StringBuilder
Требования к платформе и версии: JS (1.4)
Добавляет подпоследовательность указанного значения последовательности символов к этому построителю строк и возвращает этот экземпляр.
fun StringBuilder.appendRange(
value: CharSequence,
startIndex: Int,
endIndex: Int
): StringBuilder
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
asIterable
Создает экземпляр Iterable, который обертывает исходную последовательность символов, возвращая ее символы при итерации.
fun CharSequence.asIterable(): Iterable<Char>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
asSequence
Создает экземпляр Sequence, который обертывает исходную последовательность символов, возвращая ее символы при повторении.
fun CharSequence.asSequence(): Sequence<Char>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
associate
Возвращает карту, содержащую пары ключ-значение, предоставленные функцией преобразования, примененной к символам данной последовательности символов.
fun <K, V> CharSequence.associate(
transform: (Char) -> Pair<K, V>
): Map<K, V>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
associateBy
Возвращает карту, содержащую символы из данной последовательности символов, проиндексированных ключом, возвращенным функцией keySelector, примененной к каждому символу.
fun <K> CharSequence.associateBy( keySelector: (Char) -> K ): Map<K, Char>
Возвращает карту, содержащую значения, предоставленные valueTransform и проиндексированные функциями keySelector, примененными к символам данной последовательности символов.
fun <K, V> CharSequence.associateBy(
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): Map<K, V>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
associateByTo
Заполняет и возвращает изменяемую карту назначения парами «ключ-значение», где ключ предоставляется функцией keySelector, применяемой к каждому символу данной последовательности символов, а значение — это сам символ.
fun <K, M : MutableMap<in K, in Char>> CharSequence.associateByTo(
destination: M,
keySelector: (Char) -> K
): M
Заполняет и возвращает изменяемую карту назначения парами ключ-значение, где ключ предоставляется функцией keySelector, а значение предоставляется функцией valueTransform, применяемой к символам данной последовательности символов.
fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateByTo(
destination: M,
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): M
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
associateTo
Заполняет и возвращает изменяемую карту назначения парами «ключ-значение», предоставленными функцией преобразования, применяемой к каждому символу данной последовательности символов.
fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo(
destination: M,
transform: (Char) -> Pair<K, V>
): M
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
associateWith
Возвращает карту, где ключи являются символами из заданной последовательности символов, а значения создаются функцией valueSelector, примененной к каждому символу.
fun <V> CharSequence.associateWith( valueSelector: (Char) -> V ): Map<Char, V>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
associateWithTo
Заполняет и возвращает изменяемую карту назначения парами «ключ-значение» для каждого символа данной последовательности символов, где ключ — это сам символ, а значение предоставляется функцией valueSelector, примененной к этому ключу.
fun <V, M : MutableMap<in Char, in V>> CharSequence.associateWithTo(
destination: M,
valueSelector: (Char) -> V
): M
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
buildString
Создает новую строку, заполняя только что созданный StringBuilder, используя предоставленный builderAction, а затем преобразует его в String .
fun buildString(
builderAction: StringBuilder.() -> Unit
): String
Создает новую строку, заполняя вновь созданный StringBuilder, инициализированный заданной емкостью, с помощью предоставленного builderAction, а затем преобразует его в String .
fun buildString(
capacity: Int,
builderAction: StringBuilder.() -> Unit
): String
capitalize
Требования к платформе и версии: JVM (1.4)
Возвращает копию этой строки с заголовком первой буквы, основанной на правилах указанного языкового стандарта , или исходную строку, если она пуста или уже начинается с буквы регистра заголовка.
fun String.capitalize(locale: Locale): String
Требования к платформе и версии: JVM (1.0), JS (1.1), Native (1.3)
Возвращает копию этой строки с первой буквой в заглавном регистре,используя правила локали по умолчанию,или исходную строку,если она пуста или уже начинается с буквы в заглавном регистре.
fun String.capitalize(): String
Требования к платформе и версии: JVM (1.0)
charset
Возвращает именованный набор символов с заданным именем charsetName .
fun charset(charsetName: String): Charset
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)
chunked
Разбивает эту последовательность символов на список строк, каждая из которых не превышает заданного размера .
fun CharSequence.chunked(size: Int): List<String>
Разбивает эту последовательность символов на несколько последовательностей символов, каждая из которых не превышает заданного размера, и применяет данную функцию преобразования к каждому из них.
fun <R> CharSequence.chunked(
size: Int,
transform: (CharSequence) -> R
): List<R>
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)
chunkedSequence
Разбивает эту последовательность символов на последовательность строк, каждая из которых не превышает заданного размера .
fun CharSequence.chunkedSequence(size: Int): Sequence<String>
Разбивает эту последовательность символов на несколько последовательностей символов, каждая из которых не превышает заданного размера, и применяет данную функцию преобразования к каждому из них.
fun <R> CharSequence.chunkedSequence(
size: Int,
transform: (CharSequence) -> R
): Sequence<R>
Требования к платформе и версии: JS (1.3)
clear
Очищает содержимое этого построителя строк,делая его пустым,и возвращает этот экземпляр.
fun StringBuilder.clear(): StringBuilder
Требования к платформе и версии: JVM (1.0)
codePointAt
Возвращает символ (точка юникода)на указанном индексе.
fun String.codePointAt(index: Int): Int
Требования к платформе и версии: JVM (1.0)
codePointBefore
Возвращает символ (точка юникода)перед указанным индексом.
fun String.codePointBefore(index: Int): Int
Требования к платформе и версии: JVM (1.0)
codePointCount
Возвращает количество точек кода Юникода в указанном текстовом диапазоне данной Строки.
fun String.codePointCount( beginIndex: Int, endIndex: Int ): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
commonPrefixWith
Возвращает prefix
самой длинной строки , так что эта последовательность символов и другая последовательность символов начинаются с этого префикса, стараясь не разбивать суррогатные пары. Если этот и другие не имеют общего префикса, возвращает пустую строку.
fun CharSequence.commonPrefixWith(
other: CharSequence,
ignoreCase: Boolean = false
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
commonSuffixWith
Возвращает самый длинный строковый suffix
, так что эта последовательность символов и другая последовательность символов заканчиваются этим суффиксом, стараясь не разбивать суррогатные пары. Если этот и другие не имеют общего суффикса, возвращает пустую строку.
fun CharSequence.commonSuffixWith(
other: CharSequence,
ignoreCase: Boolean = false
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
compareTo
Сравнивает две строки лексикографически,опционально игнорируя различия в регистре.
fun String.compareTo( other: String, ignoreCase: Boolean = false ): Int
Требования к платформе и версии: JS (1.1)
concat
fun String.concat(str: String): String
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
concatToString
Объединяет символы в этом CharArray в строку.
fun CharArray.concatToString(): String
Объединяет символы в этом CharArray или его поддиапазоне в String.
fun CharArray.concatToString(
startIndex: Int = 0,
endIndex: Int = this.size
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
contains
Возвращает true
если эта последовательность символов содержит указанную другую последовательность символов в качестве подстроки.
operator fun CharSequence.contains( other: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true
если эта последовательность символов содержит указанный символ char .
operator fun CharSequence.contains( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true
, если эта последовательность символ содержит по крайней мере один матч с регулярным выражением регулярных выражений .
operator fun CharSequence.contains(regex: Regex): Boolean
contentEquals
Требования к платформе и версии: JVM (1.0)
Возвращает true
, если эта строка равна содержимому указанной CharSequence , в противном случае — false
.
fun String.contentEquals(charSequence: CharSequence): Boolean
Требования к платформе и версии: JVM (1.0)
Возвращает true
, если эта строка равна содержимому указанного StringBuffer , иначе false
.
fun String.contentEquals( stringBuilder: StringBuffer ): Boolean
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
Возвращает true
если содержимое этой последовательности символов равно содержимому указанной другой последовательности символов, т.е. обе последовательности символов содержат одинаковое количество одинаковых символов в том же порядке.
infix fun CharSequence?.contentEquals( other: CharSequence? ): Boolean
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
Возвращает true
если содержимое этой последовательности символов равно содержимому указанной другой последовательности символов , при необходимости игнорируя разницу в регистре.
fun CharSequence?.contentEquals( other: CharSequence?, ignoreCase: Boolean ): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
count
Возвращает длину этой последовательности символов.
fun CharSequence.count(): Int
Возвращает количество символов, соответствующих заданному предикату .
fun CharSequence.count(predicate: (Char) -> Boolean): Int
decapitalize
Требования к платформе и версии: JVM (1.4)
Возвращает копию этой строки, у которой первая буква в нижнем регистре с использованием правил указанного языкового стандарта , или исходная строка, если она пуста или уже начинается со строчной буквы.
fun String.decapitalize(locale: Locale): String
Требования к платформе и версии: JVM (1.0), JS (1.1), Native (1.3)
Возвращает копию этой строки с первой буквой в нижнем регистре,используя правила локали по умолчанию,или исходную строку,если она пуста или уже начинается со строчной буквы.
fun String.decapitalize(): String
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
decodeToString
Декодирует строку из байтов в кодировке UTF-8 в данном массиве.
fun ByteArray.decodeToString(): String
Декодирует строку из байтов в кодировке UTF-8 в данном массиве или его поддиапазоне.
fun ByteArray.decodeToString(
startIndex: Int = 0,
endIndex: Int = this.size,
throwOnInvalidSequence: Boolean = false
): String
Требования к платформе и версии: JS (1.4)
deleteAt
Удаляет символ по указанному индексу из этого построителя строк и возвращает этот экземпляр.
fun StringBuilder.deleteAt(index: Int): StringBuilder
Требования к платформе и версии: JS (1.4)
deleteRange
Удаляет символы в указанном диапазоне из данного построителя строк и возвращает данный экземпляр.
fun StringBuilder.deleteRange(
startIndex: Int,
endIndex: Int
): StringBuilder
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
digitToChar
Возвращает Char, представляющий эту десятичную цифру. Выдает исключение, если это значение не находится в диапазоне 0..9
.
fun Int.digitToChar(): Char
Возвращает Char, представляющий это числовое цифровое значение в указанной системе счисления . Выдает исключение, если основание системы счисления не находится в диапазоне 2..36
или если это значение не находится в диапазоне от 0 until radix
.
fun Int.digitToChar(radix: Int): Char
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
digitToInt
Возвращает числовое значение десятичной цифры,которую представляет данный символ Char.Выбрасывает исключение,если этот символ Char не является допустимой десятичной цифрой.
fun Char.digitToInt(): Int
Возвращает числовое значение цифры, которую представляет этот Char, в указанной системе счисления . Вызывает исключение, если основание системы счисления не находится в диапазоне 2..36
или если этот Char не является допустимой цифрой в указанном основании .
fun Char.digitToInt(radix: Int): Int
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
digitToIntOrNull
Возвращает числовое значение десятичной цифры, которую представляет этот Char, или null
, если этот Char не является допустимой десятичной цифрой.
fun Char.digitToIntOrNull(): Int?
Возвращает числовое значение цифры, которую представляет этот Char в указанной системе счисления , или null
если этот Char не является допустимой цифрой в указанной системе счисления . Выдает исключение, если основание системы счисления не находится в диапазоне 2..36
.
fun Char.digitToIntOrNull(radix: Int): Int?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
drop
Возвращает подпоследовательность этой последовательности символов с удаленными первыми n символами.
fun CharSequence.drop(n: Int): CharSequence
Возвращает строку с удаленными первыми n символами.
fun String.drop(n: Int): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
dropLast
Возвращает подпоследовательность этой последовательности символов с удаленными последними n символами.
fun CharSequence.dropLast(n: Int): CharSequence
Возвращает строку с удаленными последними n символами.
fun String.dropLast(n: Int): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
dropLastWhile
Возвращает подпоследовательность этой последовательности символов, содержащую все символы, кроме последних символов, которые удовлетворяют заданному предикату .
fun CharSequence.dropLastWhile(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку, содержащую все символы, кроме последних символов, которые удовлетворяют заданному предикату .
fun String.dropLastWhile(
predicate: (Char) -> Boolean
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
dropWhile
Возвращает подпоследовательность этой последовательности символов, содержащую все символы, кроме первых символов, которые удовлетворяют заданному предикату .
fun CharSequence.dropWhile(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку, содержащую все символы, кроме первых символов, которые удовлетворяют заданному предикату .
fun String.dropWhile(predicate: (Char) -> Boolean): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
elementAt
Возвращает символ по заданному индексу или выдает исключение IndexOutOfBoundsException, если индекс выходит за пределы этой последовательности символов.
fun CharSequence.elementAt(index: Int): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
elementAtOrElse
Возвращает символ по заданному индексу или результат вызова функции defaultValue, если индекс находится за пределами этой последовательности символов.
fun CharSequence.elementAtOrElse( index: Int, defaultValue: (Int) -> Char ): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
elementAtOrNull
Возвращает символ по заданному индексу или null
, если индекс выходит за пределы этой последовательности символов.
fun CharSequence.elementAtOrNull(index: Int): Char?
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
encodeToByteArray
Кодирует эту строку в массив байт в кодировке UTF-8.
fun String.encodeToByteArray(): ByteArray
Кодирует эту строку или ее подстроку в массив байт в кодировке UTF-8.
fun String.encodeToByteArray(
startIndex: Int = 0,
endIndex: Int = this.length,
throwOnInvalidSequence: Boolean = false
): ByteArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
endsWith
Возвращает true
если эта последовательность символов заканчивается указанным символом.
fun CharSequence.endsWith( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true
если эта последовательность символов заканчивается указанным суффиксом.
fun CharSequence.endsWith( suffix: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true
если эта строка заканчивается указанным суффиксом.
fun String.endsWith( suffix: String, ignoreCase: Boolean = false ): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
equals
Возвращает true
если этот символ равен другому символу, при необходимости игнорируя регистр символов.
fun Char.equals( other: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true
если эта строка равна другой , при необходимости игнорируя регистр символов.
fun String?.equals( other: String?, ignoreCase: Boolean = false ): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
filter
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые соответствуют заданному предикату .
fun CharSequence.filter(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку, содержащую только те символы из исходной строки, которые соответствуют заданному предикату .
fun String.filter(predicate: (Char) -> Boolean): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
filterIndexed
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые соответствуют заданному предикату .
fun CharSequence.filterIndexed(
predicate: (index: Int, Char) -> Boolean
): CharSequence
Возвращает строку, содержащую только те символы из исходной строки, которые соответствуют заданному предикату .
fun String.filterIndexed(
predicate: (index: Int, Char) -> Boolean
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
filterIndexedTo
Добавляет все символы, соответствующие заданному предикату, в заданное место назначения .
fun <C : Appendable> CharSequence.filterIndexedTo(
destination: C,
predicate: (index: Int, Char) -> Boolean
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
filterNot
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые не соответствуют заданному предикату .
fun CharSequence.filterNot(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку, содержащую только те символы из исходной строки, которые не соответствуют заданному предикату .
fun String.filterNot(predicate: (Char) -> Boolean): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
filterNotTo
Добавляет все символы, не соответствующие заданному предикату, в заданное место назначения .
fun <C : Appendable> CharSequence.filterNotTo(
destination: C,
predicate: (Char) -> Boolean
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
filterTo
Добавляет все символы, соответствующие заданному предикату, в заданное место назначения .
fun <C : Appendable> CharSequence.filterTo(
destination: C,
predicate: (Char) -> Boolean
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
find
Возвращает первый символ, соответствующий данному предикату , или null
, если такой символ не был найден.
fun CharSequence.find(predicate: (Char) -> Boolean): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
findAnyOf
Находит первое вхождение любой из указанных строк в этой последовательности символов, начиная с указанного startIndex и, возможно, игнорируя регистр.
fun CharSequence.findAnyOf( strings: Collection<String>, startIndex: Int = 0, ignoreCase: Boolean = false ): Pair<Int, String>?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
findLast
Возвращает последний символ, соответствующий данному предикату , или null
, если такой символ не был найден.
fun CharSequence.findLast( predicate: (Char) -> Boolean ): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
findLastAnyOf
Находит последнее вхождение любой из указанных строк в этой последовательности символов, начиная с указанного startIndex и при необходимости игнорируя регистр.
fun CharSequence.findLastAnyOf( strings: Collection<String>, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Pair<Int, String>?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
first
Возвращает первый символ.
fun CharSequence.first(): Char
Возвращает первый символ, соответствующий заданному предикату .
fun CharSequence.first(predicate: (Char) -> Boolean): Char
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
firstNotNullOf
Возвращает первое ненулевое значение, созданное функцией преобразования , применяемой к символам этой последовательности символов в порядке итерации, или выдает исключение NoSuchElementException, если не было создано ненулевого значения.
fun <R : Any> CharSequence.firstNotNullOf(
transform: (Char) -> R?
): R
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
firstNotNullOfOrNull
Возвращает первое ненулевое значение, созданное функцией преобразования , применяемой к символам этой последовательности символов в порядке итерации, или null
, если ненулевое значение не было создано.
fun <R : Any> CharSequence.firstNotNullOfOrNull(
transform: (Char) -> R?
): R?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
firstOrNull
Возвращает первый символ или null
, если последовательность символов пуста.
fun CharSequence.firstOrNull(): Char?
Возвращает первый символ, соответствующий заданному предикату , или null
, если символ не был найден.
fun CharSequence.firstOrNull( predicate: (Char) -> Boolean ): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
flatMap
Возвращает единый список всех элементов, полученных в результате вызова функции преобразования для каждого символа исходной последовательности символов.
fun <R> CharSequence.flatMap(
transform: (Char) -> Iterable<R>
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
flatMapIndexed
Возвращает единый список всех элементов, полученных в результате вызова функции преобразования для каждого символа и его индекса в исходной последовательности символов.
fun <R> CharSequence.flatMapIndexed(
transform: (index: Int, Char) -> Iterable<R>
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
flatMapIndexedTo
Добавляет все элементы, полученные в результате вызова функции преобразования для каждого символа и его индекса в исходной последовательности символов, в указанное место назначения .
fun <R, C : MutableCollection<in R>> CharSequence.flatMapIndexedTo(
destination: C,
transform: (index: Int, Char) -> Iterable<R>
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
flatMapTo
Добавляет все элементы, полученные в результате вызова функции преобразования для каждого символа исходной последовательности символов, в заданное место назначения .
fun <R, C : MutableCollection<in R>> CharSequence.flatMapTo(
destination: C,
transform: (Char) -> Iterable<R>
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
fold
Накапливает значение, начиная с начального значения и применяя операцию слева направо к текущему значению аккумулятора и каждому символу.
fun <R> CharSequence.fold(
initial: R,
operation: (acc: R, Char) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
foldIndexed
Накапливает значение, начиная с начального значения и применяя операцию слева направо к текущему значению аккумулятора и каждому символу с его индексом в исходной последовательности символов.
fun <R> CharSequence.foldIndexed(
initial: R,
operation: (index: Int, acc: R, Char) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
foldRight
Накапливает значение, начиная с начального значения и применяя операцию справа налево к каждому символу и текущему значению аккумулятора.
fun <R> CharSequence.foldRight(
initial: R,
operation: (Char, acc: R) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
foldRightIndexed
Накапливает значение, начиная с начального значения и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущим значением аккумулятора.
fun <R> CharSequence.foldRightIndexed(
initial: R,
operation: (index: Int, Char, acc: R) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
forEach
Выполняет заданное действие над каждым персонажем.
fun CharSequence.forEach(action: (Char) -> Unit)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
forEachIndexed
Выполняет заданное действие над каждым символом, обеспечивая порядковый индекс с символом.
fun CharSequence.forEachIndexed(
action: (index: Int, Char) -> Unit)
Требования к платформе и версии: JVM (1.0)
format
Использует эту строку в качестве строки форматирования и возвращает строку,полученную путем подстановки указанных аргументов,используя локаль по умолчанию.
fun String.format(vararg args: Any?): String
Использует эту строку в качестве строки форматирования и возвращает строку,полученную путем подстановки указанных аргументов,используя указанную локаль.
fun String.format(locale: Locale, vararg args: Any?): String
Использует эту строку как строку формата и возвращает строку, полученную путем подстановки указанных аргументов с использованием указанного языкового стандарта. Если языковой стандарт равен null
то локализация не применяется.
fun String.format(locale: Locale?, vararg args: Any?): String
Требования к платформе и версии: JVM (1.2), JRE8 (1.2), JS (1.2)
get
Возвращает именованную группу с указанным именем .
operator fun MatchGroupCollection.get( name: String ): MatchGroup?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
getOrElse
Возвращает символ по заданному индексу или результат вызова функции defaultValue, если индекс находится за пределами этой последовательности символов.
fun CharSequence.getOrElse( index: Int, defaultValue: (Int) -> Char ): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
getOrNull
Возвращает символ по заданному индексу или null
, если индекс выходит за пределы этой последовательности символов.
fun CharSequence.getOrNull(index: Int): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
groupBy
Группирует символы исходной последовательности символов по ключу, возвращаемому данной функцией keySelector, примененной к каждому символу, и возвращает карту, где каждый групповой ключ связан со списком соответствующих символов.
fun <K> CharSequence.groupBy( keySelector: (Char) -> K ): Map<K, List<Char>>
Группирует значения, возвращаемые функцией valueTransform, примененной к каждому символу исходной последовательности символов ключом, возвращенным данной функцией keySelector, примененной к символу, и возвращает карту, где каждый групповой ключ связан со списком соответствующих значений.
fun <K, V> CharSequence.groupBy(
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): Map<K, List<V>>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
groupByTo
Группирует символы исходной последовательности символов по ключу, возвращаемому данной функцией keySelector, примененной к каждому символу, и помещает на карту назначения каждый групповой ключ, связанный со списком соответствующих символов.
fun <K, M : MutableMap<in K, MutableList<Char>>> CharSequence.groupByTo(
destination: M,
keySelector: (Char) -> K
): M
Группирует значения, возвращаемые функцией valueTransform, примененной к каждому символу исходной последовательности символов ключом, возвращенным данной функцией keySelector, примененной к символу, и помещает на карту назначения каждый ключ группы, связанный со списком соответствующих значений.
fun <K, V, M : MutableMap<in K, MutableList<V>>> CharSequence.groupByTo(
destination: M,
keySelector: (Char) -> K,
valueTransform: (Char) -> V
): M
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
groupingBy
Создает источник группировки из последовательности символов, который будет использоваться позже с одной из операций группирования и сворачивания с использованием указанной функции keySelector для извлечения ключа из каждого символа.
fun <K> CharSequence.groupingBy( keySelector: (Char) -> K ): Grouping<Char, K>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
hasSurrogatePairAt
Возвращает true
, если эта CharSequence имеет суррогатную пару Unicode по указанному индексу .
fun CharSequence.hasSurrogatePairAt(index: Int): Boolean
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
ifBlank
Возвращает эту последовательность символов, если она не пуста и не состоит только из пробельных символов, или результат вызова функции defaultValue в противном случае.
fun <C, R> C.ifBlank( defaultValue: () -> R ): R where C : CharSequence, C : R
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
ifEmpty
Возвращает эту последовательность символов, если она не пуста, или результат вызова функции defaultValue, если последовательность символов пуста.
fun <C, R> C.ifEmpty( defaultValue: () -> R ): R where C : CharSequence, C : R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
indexOf
Возвращает индекс в этой строке первого вхождения указанного символа, начиная с указанного startIndex .
fun CharSequence.indexOf( char: Char, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Возвращает индекс в этой последовательности символов первого вхождения указанной строки , начиная с указанного startIndex .
fun CharSequence.indexOf( string: String, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
indexOfAny
Находит индекс первого вхождения любого из указанных символов в этой последовательности символов, начиная с указанного startIndex и, возможно, игнорируя регистр.
fun CharSequence.indexOfAny( chars: CharArray, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Находит индекс первого вхождения любой из указанных строк в этой последовательности символов, начиная с указанного startIndex и, возможно, игнорируя регистр.
fun CharSequence.indexOfAny( strings: Collection<String>, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
indexOfFirst
Возвращает индекс первого символа, соответствующего данному предикату , или -1, если последовательность символов не содержит такого символа.
fun CharSequence.indexOfFirst( predicate: (Char) -> Boolean ): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
indexOfLast
Возвращает индекс последнего символа, соответствующего данному предикату , или -1, если последовательность символов не содержит такого символа.
fun CharSequence.indexOfLast( predicate: (Char) -> Boolean ): Int
Требования к платформе и версии: JS (1.4)
insertRange
Вставляет символы в подмассив указанного значения массива символов в этот построитель строк по указанному индексу и возвращает этот экземпляр.
fun StringBuilder.insertRange(
index: Int,
value: CharArray,
startIndex: Int,
endIndex: Int
): StringBuilder
Вставляет символы в подпоследовательности указанного значения последовательности символов в этот построитель строк по указанному индексу и возвращает этот экземпляр.
fun StringBuilder.insertRange(
index: Int,
value: CharSequence,
startIndex: Int,
endIndex: Int
): StringBuilder
Требования к платформе и версии: JVM (1.0)
intern
Возвращает каноническое представление для этого строкового объекта.
fun String.intern(): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isBlank
Возвращает true
если эта строка пуста или состоит только из пробелов.
fun CharSequence.isBlank(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isDefined
Возвращает true
, если этот символ (кодовая точка Unicode) определен в Unicode.
fun Char.isDefined(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isDigit
Возвращает true
если этот символ является цифрой.
fun Char.isDigit(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isEmpty
Возвращает true
если эта последовательность символов пуста (не содержит символов).
fun CharSequence.isEmpty(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isHighSurrogate
Возвращает true
, если этот символ является единицей старшего суррогатного кода Unicode (также известной как единица ведущего суррогатного кода).
fun Char.isHighSurrogate(): Boolean
Требования к платформе и версии: JVM (1.0), Native (1.0)
isIdentifierIgnorable
Возвращает true
, если этот символ (кодовая точка Unicode) следует рассматривать как игнорируемый символ в идентификаторе Java или идентификаторе Unicode.
fun Char.isIdentifierIgnorable(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isISOControl
Возвращает true
если этот символ является управляющим символом ISO.
fun Char.isISOControl(): Boolean
Требования к платформе и версии: JVM (1.0)
isJavaIdentifierPart
Возвращает true
если этот символ (кодовая точка Unicode) может быть частью идентификатора Java, отличным от первого символа.
fun Char.isJavaIdentifierPart(): Boolean
Требования к платформе и версии: JVM (1.0)
isJavaIdentifierStart
Возвращает true
если этот символ разрешен в качестве первого символа в идентификаторе Java.
fun Char.isJavaIdentifierStart(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isLetter
Возвращает true
если этот символ является буквой.
fun Char.isLetter(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isLetterOrDigit
Возвращает true
если этот символ является буквой или цифрой.
fun Char.isLetterOrDigit(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isLowerCase
Возвращает true
если этот символ в нижнем регистре.
fun Char.isLowerCase(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isLowSurrogate
Возвращает true
, если этот символ является единицей младшего суррогатного кода Unicode (также известной как конечная единица суррогатного кода).
fun Char.isLowSurrogate(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isNotBlank
Возвращает true
если эта последовательность символов не пуста и содержит некоторые символы, кроме символов пробела.
fun CharSequence.isNotBlank(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isNotEmpty
Возвращает true
если эта последовательность символов не пуста.
fun CharSequence.isNotEmpty(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isNullOrBlank
Возвращает true
если эта допускающая значение null последовательность символов является либо null
либо пустой или состоит только из пробельных символов.
fun CharSequence?.isNullOrBlank(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isNullOrEmpty
Возвращает true
, если эта последовательность символов, допускающая значение NULL, является либо null
либо пустой.
fun CharSequence?.isNullOrEmpty(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
isSurrogate
Возвращает true
если этот символ является единицей суррогатного кода Unicode.
fun Char.isSurrogate(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isTitleCase
Возвращает true
если этот символ является буквой заглавного регистра.
fun Char.isTitleCase(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isUpperCase
Возвращает true
если этот символ в верхнем регистре.
fun Char.isUpperCase(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0)
isWhitespace
Определяет, является ли символ пробелом в соответствии со стандартом Unicode. Возвращает true
если символ является пробелом.
fun Char.isWhitespace(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
iterator
Итератор для символов заданной последовательности символов.
operator fun CharSequence.iterator(): CharIterator
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
last
Возвращает последнего персонажа.
fun CharSequence.last(): Char
Возвращает последний символ, соответствующий заданному предикату .
fun CharSequence.last(predicate: (Char) -> Boolean): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
lastIndexOf
Возвращает индекс в этой последовательности символов последнего вхождения указанного символа, начиная с указанного startIndex .
fun CharSequence.lastIndexOf( char: Char, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Возвращает индекс в этой последовательности символов последнего вхождения указанной строки , начиная с указанного startIndex .
fun CharSequence.lastIndexOf( string: String, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
lastIndexOfAny
Находит индекс последнего вхождения любого из указанных символов в этой последовательности символов, начиная с указанного startIndex и, возможно, игнорируя регистр.
fun CharSequence.lastIndexOfAny( chars: CharArray, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Находит индекс последнего вхождения любой из указанных строк в этой последовательности символов, начиная с указанного startIndex и, возможно, игнорируя регистр.
fun CharSequence.lastIndexOfAny( strings: Collection<String>, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
lastOrNull
Возвращает последний символ или null
, если последовательность символов пуста.
fun CharSequence.lastOrNull(): Char?
Возвращает последний символ, соответствующий данному предикату , или null
, если такой символ не был найден.
fun CharSequence.lastOrNull( predicate: (Char) -> Boolean ): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
lines
Разделяет эту последовательность символов на список строк,разделенных любой из следующих последовательностей символов:CRLF,LF или CR.
fun CharSequence.lines(): List<String>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
lineSequence
Разделяет эту символьную последовательность на последовательность строк,разделенную любой из следующих символьных последовательностей:CRLF,LF или CR.
fun CharSequence.lineSequence(): Sequence<String>
lowercase
Требования к платформе и версии: JVM (1.5)
Преобразует этот символ в нижний регистр, используя правила сопоставления Unicode указанной локали .
fun Char.lowercase(locale: Locale): String
Требования к платформе и версии: JVM (1.5)
Возвращает копию этой строки, преобразованную в нижний регистр с использованием правил указанной локали .
fun String.lowercase(locale: Locale): String
Требования к платформе и версии: JVM (1.5), JS (1.5)
Преобразует этот символ в нижний регистр,используя правила отображения Unicode в инвариантной локали.
fun Char.lowercase(): String
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
Возвращает копию этой строки,преобразованную в нижний регистр с использованием правил отображения Unicode в неизменной локали.
fun String.lowercase(): String
Требования к платформе и версии: JVM (1.5), JS (1.5)
lowercaseChar
Преобразует этот символ в нижний регистр,используя правила отображения Unicode в инвариантной локали.
fun Char.lowercaseChar(): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
map
Возвращает список, содержащий результаты применения данной функции преобразования к каждому символу в исходной последовательности символов.
fun <R> CharSequence.map(transform: (Char) -> R): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapIndexed
Возвращает список, содержащий результаты применения данной функции преобразования к каждому символу и его индекс в исходной последовательности символов.
fun <R> CharSequence.mapIndexed(
transform: (index: Int, Char) -> R
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapIndexedNotNull
Возвращает список, содержащий только ненулевые результаты применения данной функции преобразования к каждому символу и его индексу в исходной последовательности символов.
fun <R : Any> CharSequence.mapIndexedNotNull(
transform: (index: Int, Char) -> R?
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapIndexedNotNullTo
Применяет данную функцию преобразования к каждому символу и его индексу в исходной последовательности символов и добавляет только ненулевые результаты к заданному месту назначения .
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo(
destination: C,
transform: (index: Int, Char) -> R?
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapIndexedTo
Применяет данную функцию преобразования к каждому символу и его индексу в исходной последовательности символов и добавляет результаты в заданное место назначения .
fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo(
destination: C,
transform: (index: Int, Char) -> R
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapNotNull
Возвращает список, содержащий только ненулевые результаты применения данной функции преобразования к каждому символу в исходной последовательности символов.
fun <R : Any> CharSequence.mapNotNull(
transform: (Char) -> R?
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapNotNullTo
Применяет данную функцию преобразования к каждому символу в исходной последовательности символов и добавляет только ненулевые результаты в заданное место назначения .
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapNotNullTo(
destination: C,
transform: (Char) -> R?
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
mapTo
Применяет данную функцию преобразования к каждому символу исходной последовательности символов и добавляет результаты в заданное место назначения .
fun <R, C : MutableCollection<in R>> CharSequence.mapTo(
destination: C,
transform: (Char) -> R
): C
Требования к платформе и версии: JS (1.1)
match
fun String.match(regex: String): Array<String>?
matches
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
Возвращает true
, если эта последовательность символов соответствует заданному регулярному выражению.
infix fun CharSequence.matches(regex: Regex): Boolean
Требования к платформе и версии: JS (1.1)
fun String.matches(regex: String): Boolean
max
Возвращает самый большой символ.
Требования к платформе и версии: JS (1.7), Native (1.7)
fun CharSequence.max(): Char
Требования к платформе и версии: JVM (1.0)
fun CharSequence.max(): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
maxBy
Возвращает первый символ, дающий наибольшее значение данной функции.
fun <R : Comparable<R>> any_iterable<R>.maxBy( selector: (Char) -> R ): Char
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxByOrNull
Возвращает первый символ, дающий наибольшее значение данной функции, или null
, если символов нет.
fun <R : Comparable<R>> CharSequence.maxByOrNull( selector: (Char) -> R ): Char?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxOf
Возвращает наибольшее значение среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
fun <R : Comparable<R>> any_iterable<R>.maxOf(
selector: (Char) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxOfOrNull
Возвращает наибольшее значение среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов, или null
, если символов нет.
fun <R : Comparable<R>> any_iterable<R>.maxOfOrNull(
selector: (Char) -> R
): R?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxOfWith
Возвращает наибольшее значение в соответствии с предоставленным компаратором среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
fun <R> CharSequence.maxOfWith(
comparator: Comparator<in R>,
selector: (Char) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxOfWithOrNull
Возвращает наибольшее значение в соответствии с предоставленным компаратором среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов, или null
, если символы отсутствуют.
fun <R> CharSequence.maxOfWithOrNull(
comparator: Comparator<in R>,
selector: (Char) -> R
): R?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxOrNull
Возвращает наибольший символ или null
если символов нет.
fun CharSequence.maxOrNull(): Char?
maxWith
Требования к платформе и версии: JVM (1.7), JS (1.7), Native (1.7)
Возвращает первый символ, имеющий наибольшее значение в соответствии с предоставленным компаратором .
fun CharSequence.maxWith( comparator: Comparator<in Char> ): Char
Требования к платформе и версии: JVM (1.0)
fun CharSequence.maxWith( comparator: Comparator<in Char> ): Char?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
maxWithOrNull
Возвращает первый символ, имеющий наибольшее значение в соответствии с предоставленным компаратором, или null
, если символы отсутствуют.
fun CharSequence.maxWithOrNull( comparator: Comparator<in Char> ): Char?
min
Возвращает наименьший символ.
Требования к платформе и версии: JS (1.7), Native (1.7)
fun CharSequence.min(): Char
Требования к платформе и версии: JVM (1.0)
fun CharSequence.min(): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
minBy
Возвращает первый символ, дающий наименьшее значение данной функции.
fun <R : Comparable<R>> any_iterable<R>.minBy( selector: (Char) -> R ): Char
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minByOrNull
Возвращает первый символ, дающий наименьшее значение данной функции или null
, если символов нет.
fun <R : Comparable<R>> CharSequence.minByOrNull( selector: (Char) -> R ): Char?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minOf
Возвращает наименьшее значение среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
fun <R : Comparable<R>> any_iterable<R>.minOf(
selector: (Char) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minOfOrNull
Возвращает наименьшее значение среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов, или null
, если символов нет.
fun <R : Comparable<R>> any_iterable<R>.minOfOrNull(
selector: (Char) -> R
): R?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minOfWith
Возвращает наименьшее значение в соответствии с предоставленным компаратором среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
fun <R> CharSequence.minOfWith(
comparator: Comparator<in R>,
selector: (Char) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minOfWithOrNull
Возвращает наименьшее значение в соответствии с предоставленным компаратором среди всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов, или null
, если символы отсутствуют.
fun <R> CharSequence.minOfWithOrNull(
comparator: Comparator<in R>,
selector: (Char) -> R
): R?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minOrNull
Возвращает наименьший символ или null
, если символов нет.
fun CharSequence.minOrNull(): Char?
minWith
Требования к платформе и версии: JVM (1.7), JS (1.7), Native (1.7)
Возвращает первый символ, имеющий наименьшее значение в соответствии с предоставленным компаратором .
fun CharSequence.minWith( comparator: Comparator<in Char> ): Char
Требования к платформе и версии: JVM (1.0)
fun CharSequence.minWith( comparator: Comparator<in Char> ): Char?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
minWithOrNull
Возвращает первый символ, имеющий наименьшее значение в соответствии с предоставленным компаратором, или null
, если символы отсутствуют.
fun CharSequence.minWithOrNull( comparator: Comparator<in Char> ): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
none
Возвращает true
если последовательность символов не имеет символов.
fun CharSequence.none(): Boolean
Возвращает true
если ни один символ не соответствует данному предикату .
fun CharSequence.none(predicate: (Char) -> Boolean): Boolean
Требования к платформе и версии: JVM (1.0)
offsetByCodePoints
Возвращает индекс в этой строке, который смещен от данного индекса на кодовые точки codePointOffset .
fun String.offsetByCodePoints( index: Int, codePointOffset: Int ): Int
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
onEach
Выполняет заданное действие с каждым символом и впоследствии возвращает саму последовательность символов.
fun <S : CharSequence> S.onEach(action: (Char) -> Unit): S
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
onEachIndexed
Выполняет заданное действие над каждым символом, предоставляя последовательный индекс с символом, а затем возвращает саму последовательность символов.
fun <S : CharSequence> S.onEachIndexed(
action: (index: Int, Char) -> Unit
): S
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
orEmpty
Возвращает строку, если она не равна null
, или пустую строку в противном случае.
fun String?.orEmpty(): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
padEnd
Возвращает последовательность символов с содержимым этой последовательности символов, дополненным в конце до указанной длины указанным символом или пробелом.
fun CharSequence.padEnd(
length: Int,
padChar: Char = ' '
): CharSequence
Дополняет строку до указанной длины в конце указанным символом или пробелом.
fun String.padEnd(length: Int, padChar: Char = ' '): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
padStart
Возвращает последовательность символов с содержимым этой последовательности символов, дополненным в начале до указанной длины указанным символом или пробелом.
fun CharSequence.padStart(
length: Int,
padChar: Char = ' '
): CharSequence
Дополняет строку до указанной длины в начале указанным символом или пробелом.
fun String.padStart(length: Int, padChar: Char = ' '): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
partition
Разбивает исходную последовательность символов на пару последовательностей символов, где первая последовательность символов содержит символы, для которых предикат дал значение true
, а вторая последовательность символов содержит символы, для которых предикат дал значение false
.
fun CharSequence.partition(
predicate: (Char) -> Boolean
): Pair<CharSequence, CharSequence>
Разбивает исходную строку на пару строк, где первая строка содержит символы, для которых предикат дал значение true
, а вторая строка содержит символы, для которых предикат дал значение false
.
fun String.partition(
predicate: (Char) -> Boolean
): Pair<String, String>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
plus
Концентрирует этот Шар и Струну.
operator fun Char.plus(other: String): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
prependIndent
Добавляет отступ к каждой строке исходной строки.
fun String.prependIndent(indent: String = " "): String
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
random
Возвращает случайный символ из этой последовательности символов.
fun CharSequence.random(): Char
Возвращает случайный символ из этой последовательности символов,используя указанный источник случайности.
fun CharSequence.random(random: Random): Char
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
randomOrNull
Возвращает случайный символ из этой последовательности символов или null
, если эта последовательность символов пуста.
fun CharSequence.randomOrNull(): Char?
Возвращает случайный символ из этой последовательности символов, используя указанный источник случайности, или null
, если эта последовательность символов пуста.
fun CharSequence.randomOrNull(random: Random): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
reduce
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению аккумулятора и каждому символу.
fun CharSequence.reduce( operation: (acc: Char, Char) -> Char ): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
reduceIndexed
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению аккумулятора и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): Char
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
reduceIndexedOrNull
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению аккумулятора и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexedOrNull( operation: (index: Int, acc: Char, Char) -> Char ): Char?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
reduceOrNull
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению аккумулятора и каждому символу.
fun CharSequence.reduceOrNull( operation: (acc: Char, Char) -> Char ): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
reduceRight
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу и текущему значению аккумулятора.
fun CharSequence.reduceRight( operation: (Char, acc: Char) -> Char ): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
reduceRightIndexed
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущим значением аккумулятора.
fun CharSequence.reduceRightIndexed( operation: (index: Int, Char, acc: Char) -> Char ): Char
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущим значением аккумулятора.
fun CharSequence.reduceRightIndexedOrNull( operation: (index: Int, Char, acc: Char) -> Char ): Char?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
reduceRightOrNull
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу и текущему значению аккумулятора.
fun CharSequence.reduceRightOrNull( operation: (Char, acc: Char) -> Char ): Char?
regionMatches
Требования к платформе и версии: JVM (1.0), JS (1.1), Native (1.3)
Возвращает true
если указанный диапазон в этой последовательности символов равен указанному диапазону в другой последовательности символов.
fun CharSequence.regionMatches( thisOffset: Int, other: CharSequence, otherOffset: Int, length: Int, ignoreCase: Boolean = false ): Boolean
Требования к платформе и версии: JVM (1.0), Native (1.3)
Возвращает true
если указанный диапазон в этой строке равен указанному диапазону в другой строке.
fun String.regionMatches( thisOffset: Int, other: String, otherOffset: Int, length: Int, ignoreCase: Boolean = false ): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
removePrefix
Если эта последовательность символов начинается с данного префикса , возвращает новую последовательность символов с удаленным префиксом. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removePrefix(
prefix: CharSequence
): CharSequence
Если эта строка начинается с данного префикса , возвращает копию этой строки с удаленным префиксом. В противном случае возвращает эту строку.
fun String.removePrefix(prefix: CharSequence): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
removeRange
Возвращает последовательность символов с содержимым этой последовательности символов,где ее часть в данном диапазоне удалена.
fun CharSequence.removeRange(
startIndex: Int,
endIndex: Int
): CharSequence
Удаляет часть строки в заданном диапазоне.
fun String.removeRange(
startIndex: Int,
endIndex: Int
): String
Возвращает последовательность символов с содержимым этой последовательности символов, из которой удалена ее часть в заданном диапазоне .
fun CharSequence.removeRange(range: IntRange): CharSequence
Удаляет часть строки в заданном диапазоне .
fun String.removeRange(range: IntRange): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
removeSuffix
Если эта последовательность символов заканчивается заданным суффиксом , возвращает новую последовательность символов с удаленным суффиксом. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSuffix(
suffix: CharSequence
): CharSequence
Если эта строка заканчивается заданным суффиксом , возвращает копию этой строки с удаленным суффиксом. В противном случае возвращает эту строку.
fun String.removeSuffix(suffix: CharSequence): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
removeSurrounding
Когда эта последовательность символов начинается с заданного префикса и заканчивается заданным суффиксом , возвращает новую последовательность символов, в которой удалены как данный префикс, так и суффикс . В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSurrounding(
prefix: CharSequence,
suffix: CharSequence
): CharSequence
Удаляет из строки заданный префикс и суффикс тогда и только тогда, когда она начинается с префикса и заканчивается суффиксом . В противном случае возвращает эту строку без изменений.
fun String.removeSurrounding(
prefix: CharSequence,
suffix: CharSequence
): String
Когда эта последовательность символов начинается и заканчивается заданным разделителем , возвращает новую последовательность символов, в которой этот разделитель удален как из начала, так и из конца. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSurrounding(
delimiter: CharSequence
): CharSequence
Удаляет заданную строку разделителя как из начала, так и из конца этой строки тогда и только тогда, когда она начинается и заканчивается разделителем . В противном случае возвращает эту строку без изменений.
fun String.removeSurrounding(delimiter: CharSequence): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
repeat
Возвращает строку, содержащую эту последовательность символов, повторяемую n раз.
fun CharSequence.repeat(n: Int): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replace
Возвращает новую строку, полученную заменой каждой подстроки этой последовательности символов, которая соответствует данному регулярному выражению с данной заменой .
fun CharSequence.replace(
regex: Regex,
replacement: String
): String
Возвращает новую строку, полученную заменой каждой подстроки этой последовательности символов, которая соответствует данному регулярному выражению, результатом преобразования данной функции, которое принимает MatchResult и возвращает строку, которая будет использоваться в качестве замены для этого совпадения.
fun CharSequence.replace(
regex: Regex,
transform: (MatchResult) -> CharSequence
): String
Возвращает новую строку, в которой все вхождения oldChar заменены на newChar .
fun String.replace(
oldChar: Char,
newChar: Char,
ignoreCase: Boolean = false
): String
Возвращает новую строку, полученную заменой всех вхождений подстроки oldValue в этой строке указанной строкой newValue .
fun String.replace(
oldValue: String,
newValue: String,
ignoreCase: Boolean = false
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceAfter
Заменить часть строки после первого появления данного разделителя на заменяющую строку. Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.replaceAfter(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceAfter(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceAfterLast
Заменить часть строки после последнего появления данного разделителя на заменяющую строку. Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.replaceAfterLast(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceAfterLast(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceBefore
Заменить часть строки перед первым вхождением данного разделителя на заменяющую строку. Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.replaceBefore(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceBefore(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceBeforeLast
Заменить часть строки перед последним вхождением данного разделителя на заменяющую строку. Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.replaceBeforeLast(
delimiter: Char,
replacement: String,
missingDelimiterValue: String = this
): String
fun String.replaceBeforeLast(
delimiter: String,
replacement: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceFirst
Заменяет первое вхождение заданного регулярного выражения регулярных выражений в этой последовательности полукокса с указанной заменой выражением.
fun CharSequence.replaceFirst(
regex: Regex,
replacement: String
): String
Возвращает новую строку, в которой первое вхождение oldChar заменено на newChar .
fun String.replaceFirst(
oldChar: Char,
newChar: Char,
ignoreCase: Boolean = false
): String
Возвращает новую строку, полученную путем замены первого вхождения подстроки oldValue в этой строке указанной строкой newValue .
fun String.replaceFirst(
oldValue: String,
newValue: String,
ignoreCase: Boolean = false
): String
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
replaceFirstChar
Возвращает копию этой строки, в которой первый символ заменен на результат указанного преобразования , или исходную строку, если она пуста.
fun String.replaceFirstChar(
transform: (Char) -> Char
): String
fun String.replaceFirstChar(
transform: (Char) -> CharSequence
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceIndent
Обнаруживает общий минимальный отступ, как это делает trimIndent, и заменяет его указанным newIndent .
fun String.replaceIndent(newIndent: String = ""): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
replaceRange
Возвращает последовательность символов с содержимым этой последовательности символов, в которой ее часть в заданном диапазоне заменяется заменяющей последовательностью символов.
fun CharSequence.replaceRange(
startIndex: Int,
endIndex: Int,
replacement: CharSequence
): CharSequence
Заменяет часть строки в заданном диапазоне на заменяющую последовательность символов.
fun String.replaceRange(
startIndex: Int,
endIndex: Int,
replacement: CharSequence
): String
Возвращает последовательность символов с содержимым этой последовательности символов, где ее часть в заданном диапазоне заменяется заменяющей последовательностью символов.
fun CharSequence.replaceRange(
range: IntRange,
replacement: CharSequence
): CharSequence
Замените часть строки в заданном диапазоне на заменяющую строку.
fun String.replaceRange(
range: IntRange,
replacement: CharSequence
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
reversed
Возвращает последовательность символов в обратном порядке.
fun CharSequence.reversed(): CharSequence
Возвращает строку с символами в обратном порядке.
fun String.reversed(): String
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
runningFold
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу и текущему значению аккумулятора, которое начинается с начального значения.
fun <R> CharSequence.runningFold(
initial: R,
operation: (acc: R, Char) -> R
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
runningFoldIndexed
Возвращает список, содержащий последовательные значения накопления, сгенерированные применением операции слева направо к каждому символу, его индекс в исходной последовательности символов и текущее значение накопителя, которое начинается с начального значения.
fun <R> CharSequence.runningFoldIndexed(
initial: R,
operation: (index: Int, acc: R, Char) -> R
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
runningReduce
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу и текущему значению аккумулятора, которое начинается с первого символа этой последовательности символов.
fun CharSequence.runningReduce( operation: (acc: Char, Char) -> Char ): List<Char>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
runningReduceIndexed
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу, его индекс в исходной последовательности символов и текущее значение накопителя, которое начинается с первого символа этой последовательности символов.
fun CharSequence.runningReduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): List<Char>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
scan
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу и текущему значению аккумулятора, которое начинается с начального значения.
fun <R> CharSequence.scan(
initial: R,
operation: (acc: R, Char) -> R
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
scanIndexed
Возвращает список, содержащий последовательные значения накопления, сгенерированные применением операции слева направо к каждому символу, его индекс в исходной последовательности символов и текущее значение накопителя, которое начинается с начального значения.
fun <R> CharSequence.scanIndexed(
initial: R,
operation: (index: Int, acc: R, Char) -> R
): List<R>
Требования к платформе и версии: JS (1.4)
set
Устанавливает для символа по указанному индексу указанное значение .
operator fun StringBuilder.set(index: Int, value: Char)
Требования к платформе и версии: JS (1.4)
setRange
Заменяет символы в указанном диапазоне этого построителя строк на символы в указанном строковом значении и возвращает этот экземпляр.
fun StringBuilder.setRange(
startIndex: Int,
endIndex: Int,
value: String
): StringBuilder
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
single
Возвращает одиночный символ или бросает исключение,если последовательность символов символов символов символов пуста или имеет несколько символов.
fun CharSequence.single(): Char
Возвращает единственный символ, соответствующий заданному предикату , или выдает исключение, если совпадающих символов нет или больше одного.
fun CharSequence.single(predicate: (Char) -> Boolean): Char
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
singleOrNull
Возвращает один символ или null
, если последовательность символов пуста или содержит более одного символа.
fun CharSequence.singleOrNull(): Char?
Возвращает единственный символ, соответствующий данному предикату , или null
, если символ не был найден или было найдено более одного символа.
fun CharSequence.singleOrNull( predicate: (Char) -> Boolean ): Char?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
slice
Возвращает последовательность символов, содержащую символы исходной последовательности символов в указанном диапазоне индексов .
fun CharSequence.slice(indices: IntRange): CharSequence
Возвращает строку, содержащую символы исходной строки в указанном диапазоне индексов .
fun String.slice(indices: IntRange): String
Возвращает последовательность символов, содержащую символы исходной последовательности символов по указанным индексам .
fun CharSequence.slice(indices: Iterable<Int>): CharSequence
Возвращает строку, содержащую символы исходной строки по указанным индексам .
fun String.slice(indices: Iterable<Int>): String
split
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
Разбивает эту последовательность символов на список строк вокруг вхождений указанных разделителей .
fun CharSequence.split(
vararg delimiters: String,
ignoreCase: Boolean = false,
limit: Int = 0
): List<String>
fun CharSequence.split(
vararg delimiters: Char,
ignoreCase: Boolean = false,
limit: Int = 0
): List<String>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
Разбивает данную последовательность символов на список строк,состоящий из совпадений с заданным регулярным выражением.
fun CharSequence.split(
regex: Regex,
limit: Int = 0
): List<String>
Требования к платформе и версии: JVM (1.0)
Разбивает эту последовательность символов на совпадения заданного регулярного выражения.
fun CharSequence.split(
regex: Pattern,
limit: Int = 0
): List<String>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
splitToSequence
Разбивает эту последовательность символов на последовательность строк вокруг вхождений указанных разделителей .
fun CharSequence.splitToSequence(
vararg delimiters: String,
ignoreCase: Boolean = false,
limit: Int = 0
): Sequence<String>
fun CharSequence.splitToSequence(
vararg delimiters: Char,
ignoreCase: Boolean = false,
limit: Int = 0
): Sequence<String>
Разбивает данную последовательность символов на последовательность строк,состоящую из совпадений с заданным регулярным выражением.
fun CharSequence.splitToSequence(
regex: Regex,
limit: Int = 0
): Sequence<String>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
startsWith
Возвращает true
если эта последовательность символов начинается с указанного символа.
fun CharSequence.startsWith( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true
если эта последовательность символов начинается с указанного префикса.
fun CharSequence.startsWith( prefix: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true
если подстрока этой последовательности символов, начинающаяся с указанного смещения startIndex, начинается с указанного префикса.
fun CharSequence.startsWith( prefix: CharSequence, startIndex: Int, ignoreCase: Boolean = false ): Boolean
Возвращает true
если эта строка начинается с указанного префикса.
fun String.startsWith( prefix: String, ignoreCase: Boolean = false ): Boolean
Возвращает true
если подстрока этой строки, начинающаяся с указанного смещения startIndex, начинается с указанного префикса.
fun String.startsWith( prefix: String, startIndex: Int, ignoreCase: Boolean = false ): Boolean
String
Преобразует данные из части указанного массива байт в символы с использованием указанного набора символов и возвращает результат преобразования в виде строки.
Требования к платформе и версии: JVM (1.0)
fun String(
bytes: ByteArray,
offset: Int,
length: Int,
charset: Charset
): String
Преобразует данные из указанного массива байт в символы с использованием указанного набора символов и возвращает результат преобразования в виде строки.
Требования к платформе и версии: JVM (1.0)
fun String(bytes: ByteArray, charset: Charset): String
Преобразует данные из части указанного массива байт в символы с помощью набора символов UTF-8 и возвращает результат преобразования в виде строки.
Требования к платформе и версии: JVM (1.0)
fun String(
bytes: ByteArray,
offset: Int,
length: Int
): String
Преобразовывает данные из указанного массива байт в символы с помощью набора символов UTF-8 и возвращает результат преобразования в виде строки.
Требования к платформе и версии: JVM (1.0)
fun String(bytes: ByteArray): String
Преобразует точки кода из части указанного массива точек кода Unicode в строку.
Требования к платформе и версии: JVM (1.0)
fun String(
codePoints: IntArray,
offset: Int,
length: Int
): String
Преобразует содержимое указанного StringBuffer в строку.
Требования к платформе и версии: JVM (1.0)
fun String(stringBuffer: StringBuffer): String
Преобразует содержимое указанного StringBuilder в строку.
Требования к платформе и версии: JVM (1.0)
fun String(stringBuilder: StringBuilder): String
Преобразует символы в указанном массиве в строку.
Требования к платформе и версии: JS (1.2), Native (1.3)
fun String(chars: CharArray): String
Требования к платформе и версии: JVM (1.0)
fun String(chars: CharArray): String
Преобразует символы из части указанного массива в строку.
Требования к платформе и версии: JS (1.2), Native (1.3)
fun String(
chars: CharArray,
offset: Int,
length: Int
): String
Требования к платформе и версии: JVM (1.0)
fun String(
chars: CharArray,
offset: Int,
length: Int
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
subSequence
Возвращает подпоследовательность этой последовательности символов, заданную заданным диапазоном индексов.
fun CharSequence.subSequence(range: IntRange): CharSequence
Возвращает подпоследовательность этой последовательности графиков.
fun String.subSequence(start: Int, end: Int): CharSequence
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
substring
Возвращает подстроку, указанную в указанном диапазоне индексов.
fun String.substring(range: IntRange): String
Возвращает подстроку символов из диапазона этой последовательности символов, начиная с startIndex и заканчивая прямо перед endIndex .
fun CharSequence.substring(
startIndex: Int,
endIndex: Int = length
): String
Возвращает подстроку символов с индексами из указанного диапазона этой последовательности символов.
fun CharSequence.substring(range: IntRange): String
Возвращает подстроку этой строки, которая начинается с указанного startIndex и продолжается до конца строки.
fun String.substring(startIndex: Int): String
Возвращает подстроку этой строки, начиная с startIndex и заканчивая прямо перед endIndex .
fun String.substring(startIndex: Int, endIndex: Int): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
substringAfter
Возвращает подстроку после первого вхождения разделителя . Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.substringAfter(
delimiter: Char,
missingDelimiterValue: String = this
): String
fun String.substringAfter(
delimiter: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
substringAfterLast
Возвращает подстроку после последнего вхождения разделителя . Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.substringAfterLast(
delimiter: Char,
missingDelimiterValue: String = this
): String
fun String.substringAfterLast(
delimiter: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
substringBefore
Возвращает подстроку перед первым вхождением разделителя . Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.substringBefore(
delimiter: Char,
missingDelimiterValue: String = this
): String
fun String.substringBefore(
delimiter: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
substringBeforeLast
Возвращает подстроку перед последним вхождением разделителя . Если строка не содержит разделителя, возвращается значение missingDelimiterValue, которое по умолчанию соответствует исходной строке.
fun String.substringBeforeLast(
delimiter: Char,
missingDelimiterValue: String = this
): String
fun String.substringBeforeLast(
delimiter: String,
missingDelimiterValue: String = this
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
sumBy
Возвращает сумму всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
fun CharSequence.sumBy(selector: (Char) -> Int): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
sumByDouble
Возвращает сумму всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
fun CharSequence.sumByDouble( selector: (Char) -> Double ): Double
sumOf
Возвращает сумму всех значений, созданных функцией селектора, примененной к каждому символу в последовательности символов.
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun CharSequence.sumOf(selector: (Char) -> Double): Double
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun CharSequence.sumOf(selector: (Char) -> Int): Int
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun CharSequence.sumOf(selector: (Char) -> Long): Long
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
fun CharSequence.sumOf(selector: (Char) -> UInt): UInt
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
fun CharSequence.sumOf(selector: (Char) -> ULong): ULong
Требования к платформе и версии: JVM (1.4)
fun CharSequence.sumOf(
selector: (Char) -> BigDecimal
): BigDecimal
Требования к платформе и версии: JVM (1.4)
fun CharSequence.sumOf(
selector: (Char) -> BigInteger
): BigInteger
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
take
Возвращает подпоследовательность этой последовательности символов, содержащую первые n символов из этой последовательности символов, или всю последовательность символов, если эта последовательность символов короче.
fun CharSequence.take(n: Int): CharSequence
Возвращает строку, содержащую первые n символов из этой строки, или всю строку, если эта строка короче.
fun String.take(n: Int): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
takeLast
Возвращает подпоследовательность этой последовательности символов, содержащую последние n символов этой последовательности символов, или всю последовательность символов, если эта последовательность символов короче.
fun CharSequence.takeLast(n: Int): CharSequence
Возвращает строку, содержащую последние n символов из этой строки, или всю строку, если эта строка короче.
fun String.takeLast(n: Int): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
takeLastWhile
Возвращает подпоследовательность этой последовательности символов, содержащую последние символы, удовлетворяющие заданному предикату .
fun CharSequence.takeLastWhile(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку, содержащую последние символы, удовлетворяющие заданному предикату .
fun String.takeLastWhile(
predicate: (Char) -> Boolean
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
takeWhile
Возвращает подпоследовательность этой последовательности символов, содержащую первые символы, удовлетворяющие заданному предикату .
fun CharSequence.takeWhile(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку, содержащую первые символы, удовлетворяющие заданному предикату .
fun String.takeWhile(predicate: (Char) -> Boolean): String
titlecase
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
Преобразует этот символ в регистр заголовка,используя правила отображения Unicode в неизменной локали.
fun Char.titlecase(): String
Требования к платформе и версии: JVM (1.5)
Преобразует этот символ в регистр заголовка, используя правила сопоставления Unicode указанной локали .
fun Char.titlecase(locale: Locale): String
Требования к платформе и версии: JVM (1.5), JS (1.5)
titlecaseChar
Преобразует этот символ в регистр заголовка,используя правила отображения Unicode в неизменной локали.
fun Char.titlecaseChar(): Char
Требования к платформе и версии: JVM (1.2)
toBigDecimal
Анализирует строку как число java.math.BigDecimal и возвращает результат.
fun String.toBigDecimal(): BigDecimal
fun String.toBigDecimal(mathContext: MathContext): BigDecimal
Требования к платформе и версии: JVM (1.2)
toBigDecimalOrNull
Анализирует строку как java.math.BigDecimal числа и возвращает результат или null
, если строка не является правильным представлением числа.
fun String.toBigDecimalOrNull(): BigDecimal?
fun String.toBigDecimalOrNull(
mathContext: MathContext
): BigDecimal?
Требования к платформе и версии: JVM (1.2)
toBigInteger
Анализирует строку как число java.math.BigInteger и возвращает результат.
fun String.toBigInteger(): BigInteger
fun String.toBigInteger(radix: Int): BigInteger
Требования к платформе и версии: JVM (1.2)
toBigIntegerOrNull
Анализирует строку как java.math.BigInteger числа и возвращает результат или null
, если строка не является правильным представлением числа.
fun String.toBigIntegerOrNull(): BigInteger?
fun String.toBigIntegerOrNull(radix: Int): BigInteger?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toBoolean
Возвращает true
если содержимое этой строки равно слову «истина», игнорируя регистр, и false
противном случае.
fun String.toBoolean(): Boolean
Возвращает true
если эта строка не является null
и ее содержимое равно слову «истина», игнорируя регистр, и false
противном случае.
fun String?.toBoolean(): Boolean
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toBooleanStrict
Возвращает true
если содержимое этой строки равно слову «истина», false
если оно равно «ложь», и вызывает исключение в противном случае.
fun String.toBooleanStrict(): Boolean
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toBooleanStrictOrNull
Возвращает true
, если содержимое этой строки равно слову «true», false
, если оно равно «false», и null
в противном случае.
fun String.toBooleanStrictOrNull(): Boolean?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toByte
Анализирует строку как число байта со знаком и возвращает результат.
fun String.toByte(): Byte
fun String.toByte(radix: Int): Byte
Требования к платформе и версии: JVM (1.0)
toByteArray
Кодирует содержимое этой строки,используя указанный набор символов,и возвращает результирующий массив байтов.
fun String.toByteArray(
charset: Charset = Charsets.UTF_8
): ByteArray
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
toByteOrNull
Анализирует строку как число байта со знаком и возвращает результат или null
если строка не является допустимым представлением числа.
fun String.toByteOrNull(): Byte?
fun String.toByteOrNull(radix: Int): Byte?
toCharArray
Требования к платформе и версии: JVM (1.0)
Копирует символы из этой строки в целевой массив символов и возвращает этот массив.
fun String.toCharArray(
destination: CharArray,
destinationOffset: Int = 0,
startIndex: Int = 0,
endIndex: Int = length
): CharArray
Требования к платформе и версии: JVM (1.0), JS (1.4), Native (1.3)
Возвращает CharArray, содержащий символы этой строки.
fun String.toCharArray(): CharArray
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.3)
Возвращает CharArray, содержащий символы этой строки или ее подстроки.
fun String.toCharArray(
startIndex: Int = 0,
endIndex: Int = this.length
): CharArray
Требования к платформе и версии: JS (1.4)
Копирует символы из этого построителя строк в целевой массив символов.
fun StringBuilder.toCharArray(
destination: CharArray,
destinationOffset: Int = 0,
startIndex: Int = 0,
endIndex: Int = this.length)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toCollection
Добавляет все символы в данной целевой коллекции.
fun <C : MutableCollection<in Char>> CharSequence.toCollection(
destination: C
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toDouble
Анализирует строку как число Double и возвращает результат.
fun String.toDouble(): Double
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toDoubleOrNull
Анализирует строку как число Double и возвращает результат или null
если строка не является допустимым представлением числа.
fun String.toDoubleOrNull(): Double?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toFloat
Анализирует строку как число с плавающей запятой и возвращает результат.
fun String.toFloat(): Float
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toFloatOrNull
Анализирует строку как число с плавающей запятой и возвращает результат или null
если строка не является допустимым представлением числа.
fun String.toFloatOrNull(): Float?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toHashSet
Возвращает новый HashSet всех символов.
fun CharSequence.toHashSet(): HashSet<Char>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toInt
Анализирует строку как число Int и возвращает результат.
fun String.toInt(radix: Int): Int
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
toIntOrNull
Анализирует строку как число Int и возвращает результат или null
если строка не является допустимым представлением числа.
fun String.toIntOrNull(): Int?
fun String.toIntOrNull(radix: Int): Int?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toList
Возвращает список, содержащий все символы.
fun CharSequence.toList(): List<Char>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toLong
Анализирует строку как длинное число и возвращает результат.
fun String.toLong(): Long
fun String.toLong(radix: Int): Long
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
toLongOrNull
Анализирует строку как длинное число и возвращает результат или null
если строка не является допустимым представлением числа.
fun String.toLongOrNull(): Long?
fun String.toLongOrNull(radix: Int): Long?
toLowerCase
Требования к платформе и версии: JVM (1.0)
Возвращает копию этой строки,преобразованную в нижний регистр по правилам указанной локали.
fun String.toLowerCase(locale: Locale): String
Требования к платформе и версии: JVM (1.0), JS (1.1)
Преобразует этот символ в нижний регистр,используя правила отображения Unicode в инвариантной локали.
fun Char.toLowerCase(): Char
Требования к платформе и версии: JVM (1.0), JS (1.1), Native (1.3)
Возвращает копию этой строки,преобразованную в нижний регистр по правилам локали по умолчанию.
fun String.toLowerCase(): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toMutableList
Возвращает новый MutableList, заполненный всеми символами этой последовательности символов.
fun CharSequence.toMutableList(): MutableList<Char>
Требования к платформе и версии: JVM (1.0)
toPattern
Преобразует строку в регулярное выражение Pattern ( необязательно) с указанными флагами из Pattern или вместе, чтобы строки можно было разделить или сопоставить.
fun String.toPattern(flags: Int = 0): Pattern
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toRegex
Преобразует строку в регулярное выражение Regex с параметрами по умолчанию.
fun String.toRegex(): Regex
Преобразует строку в регулярное выражение Regex с указанным единственным параметром .
fun String.toRegex(option: RegexOption): Regex
Преобразует строку в регулярное выражение Regex с указанным набором параметров .
fun String.toRegex(options: Set<RegexOption>): Regex
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toSet
Возвращает набор всех символов.
fun CharSequence.toSet(): Set<Char>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
toShort
Анализирует строку как короткое число и возвращает результат.
fun String.toShort(): Short
fun String.toShort(radix: Int): Short
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
toShortOrNull
Анализирует строку как короткое число и возвращает результат или null
если строка не является допустимым представлением числа.
fun String.toShortOrNull(): Short?
fun String.toShortOrNull(radix: Int): Short?
Требования к платформе и версии: JVM (1.0)
toSortedSet
Возвращает новый SortedSet всех символов.
fun CharSequence.toSortedSet(): SortedSet<Char>
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
toString
Возвращает строковое представление этого байтового значения в указанной системе счисления .
fun UByte.toString(radix: Int): String
fun Byte.toString(radix: Int): String
Возвращает строковое представление этого значения Short с указанным основанием системы счисления .
fun UShort.toString(radix: Int): String
fun Short.toString(radix: Int): String
Возвращает строковое представление этого значения Int с указанным основанием системы счисления .
fun UInt.toString(radix: Int): String
fun Int.toString(radix: Int): String
Возвращает строковое представление этого значения Long с указанным основанием системы счисления .
fun ULong.toString(radix: Int): String
fun Long.toString(radix: Int): String
Требования к платформе и версии: JVM (1.0)
toTitleCase
Преобразует этот символ в регистр заголовка,используя правила отображения Unicode в неизменной локали.
fun Char.toTitleCase(): Char
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toUByte
Анализирует строку как подписанное число UByte и возвращает результат.
fun String.toUByte(): UByte
fun String.toUByte(radix: Int): UByte
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toUByteOrNull
Анализирует строку как UBYTE числа и возвращает результат или null
, если строка не является правильным представлением числа.
fun String.toUByteOrNull(): UByte?
fun String.toUByteOrNull(radix: Int): UByte?
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toUInt
Анализирует строку как число UInt и возвращает результат.
fun String.toUInt(): UInt
fun String.toUInt(radix: Int): UInt
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toUIntOrNull
Анализирует строку как UInt числа и возвращает результат или null
, если строка не является правильным представлением числа.
fun String.toUIntOrNull(): UInt?
fun String.toUIntOrNull(radix: Int): UInt?
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toULong
Анализирует строку как число ULong и возвращает результат.
fun String.toULong(): ULong
fun String.toULong(radix: Int): ULong
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toULongOrNull
Анализирует строку как ULong числа и возвращает результат или null
, если строка не является правильным представлением числа.
fun String.toULongOrNull(): ULong?
fun String.toULongOrNull(radix: Int): ULong?
toUpperCase
Требования к платформе и версии: JVM (1.0)
Возвращает копию этой строки,преобразованную в верхний регистр по правилам указанной локали.
fun String.toUpperCase(locale: Locale): String
Требования к платформе и версии: JVM (1.0), JS (1.1)
Преобразует этот символ в верхний регистр,используя правила отображения Unicode в инвариантной локали.
fun Char.toUpperCase(): Char
Требования к платформе и версии: JVM (1.0), JS (1.1), Native (1.3)
Возвращает копию этой строки,преобразованную в верхний регистр по правилам локали по умолчанию.
fun String.toUpperCase(): String
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toUShort
Анализирует строку как номер UShort и возвращает результат.
fun String.toUShort(): UShort
fun String.toUShort(radix: Int): UShort
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
toUShortOrNull
Анализирует строку как UShort числа и возвращает результат или null
, если строка не является правильным представлением числа.
fun String.toUShortOrNull(): UShort?
fun String.toUShortOrNull(radix: Int): UShort?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
trim
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные и конечные символы, соответствующие предикату .
fun CharSequence.trim(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку с начальными и конечными символами, соответствующими удаленному предикату .
fun String.trim(predicate: (Char) -> Boolean): String
Возвращает подпоследовательность этой последовательности символов с удаленными начальными и конечными символами из массива символов .
fun CharSequence.trim(vararg chars: Char): CharSequence
Возвращает строку с удаленными начальными и конечными символами из массива chars .
fun String.trim(vararg chars: Char): String
Возвращает подпоследовательность этого символа с удалением лидирующего и скользящего пробела.
fun CharSequence.trim(): CharSequence
Возвращает строку с удалением лидирующего и скользящего пробела.
fun String.trim(): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
trimEnd
Возвращает подпоследовательность этой символьной последовательности с удаленными завершающими символами, соответствующими предикату .
fun CharSequence.trimEnd(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку с завершающими символами, соответствующими удаленному предикату .
fun String.trimEnd(predicate: (Char) -> Boolean): String
Возвращает подпоследовательность этой последовательности символов с удаленными завершающими символами из массива символов .
fun CharSequence.trimEnd(vararg chars: Char): CharSequence
Возвращает строку с удаленными завершающими символами из массива chars .
fun String.trimEnd(vararg chars: Char): String
Возвращает подпоследовательность этого символа с удалением пробела.
fun CharSequence.trimEnd(): CharSequence
Возвращает строку с удаленными пробелами.
fun String.trimEnd(): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
trimIndent
Обнаруживает общий минимальный отступ всех строк ввода,удаляет его из каждой строки,а также удаляет первую и последнюю строки,если они пустые (обратите внимание на разницу между пустыми и пустыми).
fun String.trimIndent(): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
trimMargin
Обрезает начальные пробельные символы, за которыми следует marginPrefix, из каждой строки исходной строки и удаляет первую и последнюю строки, если они пустые (обратите внимание на разницу между пустым и пустым).
fun String.trimMargin(marginPrefix: String = "|"): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
trimStart
Возвращает подпоследовательность этой последовательности символов с удаленными ведущими символами, соответствующими предикату .
fun CharSequence.trimStart(
predicate: (Char) -> Boolean
): CharSequence
Возвращает строку с начальными символами, соответствующими удаленному предикату .
fun String.trimStart(predicate: (Char) -> Boolean): String
Возвращает подпоследовательность этой последовательности символов с удаленными ведущими символами из массива символов .
fun CharSequence.trimStart(vararg chars: Char): CharSequence
Возвращает строку с удаленными ведущими символами из массива chars .
fun String.trimStart(vararg chars: Char): String
Возвращает подпоследовательность этой последовательности символов с удалением лидирующего пробела.
fun CharSequence.trimStart(): CharSequence
Возвращает строку с удалением лидирующего пробела.
fun String.trimStart(): String
uppercase
Требования к платформе и версии: JVM (1.5)
Преобразует этот символ в верхний регистр, используя правила отображения Unicode для указанной локали .
fun Char.uppercase(locale: Locale): String
Требования к платформе и версии: JVM (1.5)
Возвращает копию этой строки, преобразованную в верхний регистр с использованием правил указанной локали .
fun String.uppercase(locale: Locale): String
Требования к платформе и версии: JVM (1.5), JS (1.5)
Преобразует этот символ в верхний регистр,используя правила отображения Unicode в инвариантной локали.
fun Char.uppercase(): String
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
Возвращает копию этой строки,преобразованную в верхний регистр с использованием правил отображения Unicode в неизменной локали.
fun String.uppercase(): String
Требования к платформе и версии: JVM (1.5), JS (1.5)
uppercaseChar
Преобразует этот символ в верхний регистр,используя правила отображения Unicode в инвариантной локали.
fun Char.uppercaseChar(): Char
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)
windowed
Возвращает список снимков окна заданного размера, скользящего по этой последовательности символов с заданным шагом , где каждый снимок представляет собой строку.
fun CharSequence.windowed(
size: Int,
step: Int = 1,
partialWindows: Boolean = false
): List<String>
Возвращает список результатов применения данной функции преобразования к каждой последовательности символов, представляющей вид окна заданного размера, скользящего по этой последовательности символов с заданным шагом .
fun <R> CharSequence.windowed(
size: Int,
step: Int = 1,
partialWindows: Boolean = false,
transform: (CharSequence) -> R
): List<R>
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)
windowedSequence
Возвращает последовательность снимков окна заданного размера, скользящую по этой последовательности символов с заданным шагом , где каждый снимок представляет собой строку.
fun CharSequence.windowedSequence(
size: Int,
step: Int = 1,
partialWindows: Boolean = false
): Sequence<String>
Возвращает последовательность результатов применения данной функции преобразования к каждой последовательности символов, представляющей вид окна заданного размера, скользящего по этой последовательности символов с заданным шагом .
fun <R> CharSequence.windowedSequence(
size: Int,
step: Int = 1,
partialWindows: Boolean = false,
transform: (CharSequence) -> R
): Sequence<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
withIndex
Возвращает ленивый Iterable, который оборачивает каждый символ исходной последовательности символов в IndexedValue, содержащее индекс этого символа и сам символ.
fun CharSequence.withIndex(): Iterable<IndexedValue<Char>>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
zip
Возвращает список пар, составленных из символов this
и других последовательностей символов с тем же индексом. Возвращенный список имеет длину самой короткой последовательности символов.
infix fun CharSequence.zip( other: CharSequence ): List<Pair<Char, Char>>
Возвращает список значений, составленный из символов this
и других последовательностей символов с тем же индексом, используя предоставленную функцию преобразования, примененную к каждой паре символов. Возвращенный список имеет длину самой короткой последовательности символов.
fun <V> CharSequence.zip(
other: CharSequence,
transform: (a: Char, b: Char) -> V
): List<V>
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)
zipWithNext
Возвращает список пар каждых двух соседних символов в этой последовательности графиков.
fun CharSequence.zipWithNext(): List<Pair<Char, Char>>
Возвращает список, содержащий результаты применения данной функции преобразования к каждой паре двух соседних символов в этой последовательности символов.
fun <R> CharSequence.zipWithNext(
transform: (a: Char, b: Char) -> R
): List<R>
Introduction :
In this kotlin programming tutorial, we will learn how to check if a substring exists in another string or not. The program will take the strings as input from the user and print out the result.
We will learn how to check if the string contains a substring by ignoring all case of each character during the checking and by not ignoring the case.
Kotlin contains method :
Kotlin String class has one method called contains to check if a string contains another substring or not. It takes two arguments :
-
The first argument is the substring that we need to check.
-
The second argument is one boolean value ignoreCase. If true, the checking will ignore all character case, else if false, it will not ignore the character case.
Below examples will add more clarity to you :
Check substring in a string without ignoring case :
Let’s try to implement the contains method by not ignoring all character case :
fun main(args: Array) {
val line: String
val subStr: String
print("Enter a string : ")
line = readLine().toString()
print("Enter a sub string : ")
subStr = readLine().toString()
if (line.contains(subStr, false)) {
print("String '$line' contains substring '$subStr'")
} else {
print("String '$line' doesn't contain substring '$subStr'")
}
}
The output of the above program will look like below :
Enter a string : Hello World
Enter a sub string : Hello
String 'Hello World' contains substring 'Hello'
Enter a string : Hello World
Enter a sub string : hello
String 'Hello World' doesn't contain substring 'hello'
As you can see, if we are passing false to the contains method, it checks the character case while comparing.
Check substring in a string ignoring case :
For checking substring in a string ignoring case, the only thing we need to do is pass true instead of false as the above example.
fun main(args: Array) {
val line: String
val subStr: String
print("Enter a string : ")
line = readLine().toString()
print("Enter a sub string : ")
subStr = readLine().toString()
if (line.contains(subStr, true)) {
print("String '$line' contains substring '$subStr'")
} else {
print("String '$line' doesn't contain substring '$subStr'")
}
}
Sample Output :
Enter a string : Hello World
Enter a sub string : Hello
String 'Hello World' contains substring 'Hello'
Enter a string : Hello String
Enter a sub string : hello
String 'Hello String' contains substring 'hello'
Conclusion :
We have learned how to check if a substring exists in a string or not in Kotlin. Try to run both examples we have shown above and drop one comment below if you have any queries.
This language bar is your friend. Select your favorite languages!
- Kotlin
- Kotlin
- Demo
- Doc
- Ada
- C
- Clojure
- C++
- C#
- D
- Dart
- Elixir
- Erlang
- Fortran
- Go
- Haskell
- JS
- JS
- Java
- Lisp
- Lua
- Lua
- Lua
- Obj-C
- PHP
- PHP
- PHP
- Pascal
- Perl
- Python
- Ruby
- Rust
- Scala
- Smalltalk
- VB
with Ada.Strings.Fixed;
use Ada.Strings.Fixed;
Ok : Boolean := Index (S, Word) > 0;
int ok = strstr(s,word) != NULL;
- Demo
- Doc
(require '[clojure.string :as string])
(def ok (string/includes? word s))
- Doc
var ok = s.Contains(word);
- Demo
- Doc
import std.algorithm.searching;
bool ok = s.canFind(word);
var ok = s.contains(word);
- Demo
- Doc
ok = String.contains?(s, word)
- Doc
Ok = string:str(S, Word) > 0.
- Demo
- Doc
ok = index(string, word) /= 0
ok := strings.Contains(s, word)
- Demo
- Doc
var ok = s.indexOf(word) !== -1;
- Doc
boolean ok = s.contains(word);
- Demo
- Doc
(setf ok (search word s))
- Doc
ok = s:find(word, 1, true)
ok = false
if s:find(word, 1, true) then ok = true end
ok = s:find(word, 1, true) ~= nil
BOOL ok=[s containsString:word];
$mystring = 'abc';
$findme = 'a';
$pos = strpos($mystring, $findme);
// Nótese el uso de ===. Puesto que == simple no funcionará como se espera
// porque la posición de 'a' está en el 1° (primer) caracter.
if ($pos === false) {
echo "La cadena '$findme' no fue encontrada en la cadena '$mystring'";
} else {
echo "La cadena '$findme' fue encontrada en la cadena '$mystring'";
echo " y existe en la posición $pos";
}
$mystring = 'abc';
$findme = 'a';
$pos = strpos($mystring, $findme);
// Nótese el uso de ===. Puesto que == simple no funcionará como se espera
// porque la posición de 'a' está en el 1° (primer) caracter.
if ($pos === false) {
echo "La cadena '$findme' no fue encontrada en la cadena '$mystring'";
} else {
echo "La cadena '$findme' fue encontrada en la cadena '$mystring'";
echo " y existe en la posición $pos";
}
$ok = str_contains($s, $word);
- Demo
- Doc
$ok = index($s,$word) >= 0;
- Demo
- Doc
- Demo
- Doc
let ok = s.contains(word);
- Demo
- Doc
ok := s includesSubstring: word.
Dim ok As Boolean = s.Contains(word)
- Kotlin
val ok = s.contains(word)
- Kotlin
val ok = word in s
- Ada
Ok : Boolean := Index (S, Word) > 0;
- C
int ok = strstr(s,word) != NULL;
- Clojure
(def ok (string/includes? word s))
- C++
bool ok = s.find(word) != std::string::npos;
- C#
var ok = s.Contains(word);
- D
bool ok = s.canFind(word);
- Dart
var ok = s.contains(word);
- Elixir
ok = String.contains?(s, word)
- Erlang
Ok = string:str(S, Word) > 0.
- Fortran
ok = index(string, word) /= 0
- Go
ok := strings.Contains(s, word)
- Haskell
ok = word `isInfixOf` s
- JS
var ok = s.includes(word);
- JS
var ok = s.indexOf(word) !== -1;
- Java
boolean ok = s.contains(word);
- Lisp
(setf ok (search word s))
- Lua
ok = s:find(word, 1, true)
- Lua
ok = false if s:find(word, 1, true) then ok = true end
- Lua
ok = s:find(word, 1, true) ~= nil
- Obj-C
BOOL ok=[s containsString:word];
- PHP
$mystring = 'abc'; $findme = 'a'; $pos = strpos($mystring, $findme); // Nótese el uso de ===. Puesto que == simple no funcionará como se espera // porque la posición de 'a' está en el 1° (primer) caracter. if ($pos === false) { echo "La cadena '$findme' no fue encontrada en la cadena '$mystring'"; } else { echo "La cadena '$findme' fue encontrada en la cadena '$mystring'"; echo " y existe en la posición $pos"; }
- PHP
$mystring = 'abc'; $findme = 'a'; $pos = strpos($mystring, $findme); // Nótese el uso de ===. Puesto que == simple no funcionará como se espera // porque la posición de 'a' está en el 1° (primer) caracter. if ($pos === false) { echo "La cadena '$findme' no fue encontrada en la cadena '$mystring'"; } else { echo "La cadena '$findme' fue encontrada en la cadena '$mystring'"; echo " y existe en la posición $pos"; }
- PHP
$ok = str_contains($s, $word);
- Pascal
ok := pos(word,s)<>0;
- Perl
$ok = index($s,$word) >= 0;
- Ruby
ok = s.include?(word)
- Rust
let ok = s.contains(word);
- Scala
val ok = s.contains(word)
- Smalltalk
ok := s includesSubstring: word.
- VB
Dim ok As Boolean = s.Contains(word)