Строка
class String : Comparable<String>, CharSequence
Класс String представляет строки символов. Все строковые литералы в программах Kotlin, такие как "abc", реализуются как экземпляры этого класса.
Конструкторы
<init>
Класс String представляет строки символов. Все строковые литералы в программах Kotlin, такие как "abc", реализуются как экземпляры этого класса.
<init>()
Свойства
длина
Возвращает длину этой последовательности символов.
val length: Int
Функции
compareTo
equals
Указывает, является ли другой объект "равным" этому. Реализации должны удовлетворять следующим требованиям:
fun equals(other: Any?): Boolean
get
Возвращает символ этой строки по указанному индексу.
fun get(index: Int): Char
hashCode
Возвращает значение хэш-кода для объекта. Общее соглашение hashCode:
fun hashCode(): Int
plus
Возвращает строку, полученную путем конкатенации этой строки со строковым представлением данного объекта other.
operator fun plus(other: Any?): String
subSequence
Возвращает новую последовательность символов, которая является подпоследовательностью этой последовательности символов, начиная с указанного startIndex и заканчивая непосредственно перед указанным endIndex.
fun subSequence(startIndex: Int, endIndex: Int): CharSequence
toString
Возвращает строковое представление объекта.
fun toString(): String
Расширенные свойства
cstr
val String.cstr: CValues<ByteVar>
индексы
Возвращает диапазон допустимых индексов символов для этой последовательности символов.
val CharSequence.indices: IntRange
последний индекс
Возвращает индекс последнего символа в последовательности символов или -1, если она пуста.
val CharSequence.lastIndex: Int
utf16
val String.utf16: CValues<UShortVar>
utf32
val String.utf32: CValues<IntVar>
utf8
val String.utf8: CValues<ByteVar>
wcstr
val String.wcstr: CValues<UShortVar>
Расширенные функции
all
Возвращает true если все символы соответствуют заданному предикату.
fun CharSequence.all(predicate: (Char) -> Boolean): Boolean
any
Возвращает true если последовательность символов содержит хотя бы один символ.
fun CharSequence.any(): Boolean
Возвращает true если хотя бы один символ соответствует заданному предикату.
fun CharSequence.any(predicate: (Char) -> Boolean): Boolean
asIterable
Создаёт экземпляр Iterable, который оборачивает исходную последовательность символов, возвращая её символы при итерировании.
fun CharSequence.asIterable(): Iterable<Char>
asSequence
Создаёт экземпляр Sequence, который оборачивает исходную последовательность символов, возвращая её символы при итерировании.
fun CharSequence.asSequence(): Sequence<Char>
associate
associateBy
Возвращает Map содержащий символы из заданной последовательности символов, индексированные ключом, возвращённым из функции keySelector, применённой к каждому символу.
fun <K> CharSequence.associateBy( keySelector: (Char) -> K ): Map<K, Char>
Возвращает Map содержащий значения, предоставленные функцией valueTransform, и индексированные функцией keySelector, применённой к символам заданной последовательности символов.
fun <K, V> CharSequence.associateBy( keySelector: (Char) -> K, valueTransform: (Char) -> V ): Map<K, V>
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
associateTo
associateWith
Возвращает Map, где ключами являются символы из заданной последовательности символов, а значения генерируются функцией valueSelector, применённой к каждому символу.
fun <V> CharSequence.associateWith( valueSelector: (Char) -> V ): Map<Char, V>
associateWithTo
Заполняет и возвращает изменяемый словарь парами ключ-значение для каждого символа заданной последовательности символов, где ключом является сам символ, а значение предоставляется функцией valueSelector, применённой к этому ключу.
fun <V, M : MutableMap<in Char, in V>> CharSequence.associateWithTo( destination: M, valueSelector: (Char) -> V ): M
byteInputStream
Создаёт новый поток для ввода байтов для строки.
fun String.byteInputStream( charset: Charset = Charsets.UTF_8 ): ByteArrayInputStream
capitalize
Возвращает копию этой строки, в которой первая буква заглавная, используя правила указанного локали, или исходную строку, если она пустая или уже начинается с заглавной буквы.
fun String.capitalize(locale: Locale): String
chunked
Разделяет эту последовательность символов на список строк, каждая из которых не превышает заданного размера.
fun CharSequence.chunked(size: Int): List<String>
Разделяет эту последовательность символов на несколько последовательностей символов, каждая из которых не превышает заданного размера, и применяет заданную функцию преобразования к каждой.
fun <R> CharSequence.chunked( size: Int, transform: (CharSequence) -> R ): List<R>
chunkedSequence
Разделяет эту последовательность символов на последовательность строк, каждая из которых не превышает заданного размера.
fun CharSequence.chunkedSequence(size: Int): Sequence<String>
Разделяет эту последовательность символов на несколько последовательностей символов, каждая из которых не превышает заданного размера, и применяет заданную функцию преобразования к каждой.
fun <R> CharSequence.chunkedSequence( size: Int, transform: (CharSequence) -> R ): Sequence<R>
codePointAt
Возвращает символ (код точки Юникода) по указанному индексу.
fun String.codePointAt(index: Int): Int
codePointBefore
Возвращает символ (код точки Юникода) перед указанным индексом.
fun String.codePointBefore(index: Int): Int
codePointCount
Возвращает количество точек кода Юникода в указанном текстовом диапазоне этой строки.
fun String.codePointCount( beginIndex: Int, endIndex: Int ): Int
coerceAtLeast
Обеспечивает, что это значение не меньше указанного минимального значения.
fun <T : Comparable<T>> T.coerceAtLeast(minimumValue: T): T
coerceAtMost
Обеспечивает, что это значение не больше указанного максимального значения.
fun <T : Comparable<T>> T.coerceAtMost(maximumValue: T): T
coerceIn
Обеспечивает, что это значение находится в заданном диапазоне minimumValue..maximumValue.
fun <T : Comparable<T>> T.coerceIn( minimumValue: T?, maximumValue: T? ): T
Обеспечивает, что это значение находится в заданном диапазоне.
fun <T : Comparable<T>> T.coerceIn( range: ClosedFloatingPointRange<T> ): T
fun <T : Comparable<T>> T.coerceIn(range: ClosedRange<T>): T
commonPrefixWith
Возвращает самую длинную строку prefix такую, что эта последовательность символов и последовательность символов other обе начинаются с этого префикса, учитывая, что не разделяются пары суррогатов. Если у этой и other нет общего префикса, возвращает пустую строку.
fun CharSequence.commonPrefixWith( other: CharSequence, ignoreCase: Boolean = false ): String
commonSuffixWith
Возвращает самую длинную строку suffix такую, что эта последовательность символов и последовательность символов other обе заканчиваются этой суффиксом, учитывая, что не разделяются пары суррогатов. Если у этой и other нет общего суффикса, возвращает пустую строку.
fun CharSequence.commonSuffixWith( other: CharSequence, ignoreCase: Boolean = false ): String
compareTo
concat
fun String.concat(str: String): String
contains
Возвращает true если эта последовательность символов содержит указанную другую последовательность символов в качестве подстроки.
operator fun CharSequence.contains( other: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта последовательность символов содержит указанный символ символ.
operator fun CharSequence.contains( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта последовательность символов содержит по крайней мере одно соответствие указанному регулярному выражению regex.
operator fun CharSequence.contains(regex: Regex): Boolean
contentEquals
Возвращает true если эта строка равна содержимому указанного CharSequence, false в противном случае.
fun String.contentEquals(charSequence: CharSequence): Boolean
Возвращает true если эта строка равна содержимому указанного StringBuffer, false в противном случае.
fun String.contentEquals( stringBuilder: StringBuffer ): Boolean
count
Возвращает длину этой последовательности символов.
fun CharSequence.count(): Int
Возвращает количество символов, соответствующих заданному предикату.
fun CharSequence.count(predicate: (Char) -> Boolean): Int
decapitalize
Возвращает копию этой строки, в которой первая буква приведена к нижнему регистру в соответствии с правилами указанной локали, или исходную строку, если она пустая или уже начинается с буквы в нижнем регистре.
fun String.decapitalize(locale: Locale): String
drop
Возвращает строку, из которой удалены первые n символов.
fun String.drop(n: Int): String
dropLast
Возвращает строку, из которой удалены последние n символов.
fun String.dropLast(n: Int): String
dropLastWhile
Возвращает строку, содержащую все символы, кроме последних символов, удовлетворяющих заданному предикату.
fun String.dropLastWhile( predicate: (Char) -> Boolean ): String
dropWhile
Возвращает строку, содержащую все символы, кроме первых символов, удовлетворяющих заданному предикату.
fun String.dropWhile(predicate: (Char) -> Boolean): String
elementAtOrElse
Возвращает символ по заданному индексу или результат вызова функции defaultValue, если индекс выходит за пределы этой последовательности символов.
fun CharSequence.elementAtOrElse( index: Int, defaultValue: (Int) -> Char ): Char
elementAtOrNull
endsWith
Возвращает true если эта последовательность символов заканчивается указанным символом.
fun CharSequence.endsWith( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true если эта последовательность символов заканчивается указанным суффиксом.
fun CharSequence.endsWith( suffix: CharSequence, ignoreCase: Boolean = false ): Boolean
filter
Возвращает строку, содержащую только те символы из исходной строки, которые соответствуют заданному предикату.
fun String.filter(predicate: (Char) -> Boolean): String
filterIndexed
Возвращает строку, содержащую только те символы из исходной строки, которые соответствуют заданному предикату.
fun String.filterIndexed( predicate: (index: Int, Char) -> Boolean ): String
filterIndexedTo
Добавляет все символы, соответствующие заданному предикату, в заданный destination.
fun <C : Appendable> CharSequence.filterIndexedTo( destination: C, predicate: (index: Int, Char) -> Boolean ): C
filterNot
Возвращает строку, содержащую только те символы из исходной строки, которые не соответствуют заданному предикату.
fun String.filterNot(predicate: (Char) -> Boolean): String
filterNotTo
Добавляет все символы, не соответствующие заданному предикату, в заданный destination.
fun <C : Appendable> CharSequence.filterNotTo( destination: C, predicate: (Char) -> Boolean ): C
filterTo
Добавляет все символы, соответствующие заданному предикату, в заданный destination.
fun <C : Appendable> CharSequence.filterTo( destination: C, predicate: (Char) -> Boolean ): C
find
Возвращает первый символ, соответствующий заданному предикату, или null если такой символ не найден.
fun CharSequence.find(predicate: (Char) -> Boolean): Char?
findAnyOf
Находит первое вхождение любого из указанных строк в этой последовательности символов, начиная с указанного startIndex и необязательно игнорируя регистр.
fun CharSequence.findAnyOf( strings: Collection<String>, startIndex: Int = 0, ignoreCase: Boolean = false ): Pair<Int, String>?
findLast
Возвращает последний символ, соответствующий заданному предикату, или null если такой символ не найден.
fun CharSequence.findLast( predicate: (Char) -> Boolean ): Char?
findLastAnyOf
Находит последнее вхождение любого из указанных строк в этой последовательности символов, начиная с указанного startIndex и необязательно игнорируя регистр.
fun CharSequence.findLastAnyOf( strings: Collection<String>, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Pair<Int, String>?
first
Возвращает первый символ.
fun CharSequence.first(): Char
Возвращает первый символ, соответствующий заданному предикату.
fun CharSequence.first(predicate: (Char) -> Boolean): Char
firstNotNullOf
Возвращает первое не null значение, полученное с помощью функции transform, применяемой к символам этой последовательности символов в порядке итерации, или вызывает исключение NoSuchElementException, если не было получено ни одного не null значения.
fun <R : Any> CharSequence.firstNotNullOf( transform: (Char) -> R? ): R
firstNotNullOfOrNull
Возвращает первое не null значение, полученное с помощью функции transform, применяемой к символам этой последовательности символов в порядке итерации, или null если не было получено ни одного не null значения.
fun <R : Any> CharSequence.firstNotNullOfOrNull( transform: (Char) -> R? ): R?
firstOrNull
Возвращает первый символ, или null если последовательность символов пуста.
fun CharSequence.firstOrNull(): Char?
Возвращает первый символ, соответствующий заданному предикату, или null если символ не найден.
fun CharSequence.firstOrNull( predicate: (Char) -> Boolean ): Char?
flatMap
Возвращает один список всех элементов, полученных в результате вызова функции transform для каждого символа исходной последовательности символов.
fun <R> CharSequence.flatMap( transform: (Char) -> Iterable<R> ): List<R>
flatMapIndexed
Возвращает один список всех элементов, полученных в результате вызова функции transform для каждого символа и его индекса в исходной последовательности символов.
fun <R> CharSequence.flatMapIndexed( transform: (index: Int, Char) -> Iterable<R> ): List<R>
flatMapIndexedTo
Добавляет все элементы, полученные в результате вызова функции transform для каждого символа и его индекса в исходной последовательности символов, в указанный destination.
fun <R, C : MutableCollection<in R>> CharSequence.flatMapIndexedTo( destination: C, transform: (index: Int, Char) -> Iterable<R> ): C
flatMapTo
Добавляет все элементы, полученные в результате вызова функции transform для каждого символа исходной последовательности символов, в указанный destination.
fun <R, C : MutableCollection<in R>> CharSequence.flatMapTo( destination: C, transform: (Char) -> Iterable<R> ): C
fold
foldIndexed
foldRight
foldRightIndexed
forEach
Выполняет заданное action для каждого символа.
fun CharSequence.forEach(action: (Char) -> Unit)
forEachIndexed
Выполняет заданное action для каждого символа, предоставляя порядковый индекс с символом.
fun CharSequence.forEachIndexed( action: (index: Int, Char) -> Unit)
format
Использует эту строку в качестве строки формата и возвращает строку, полученную путем подстановки указанных аргументов, используя языковые стандарты по умолчанию.
fun String.format(vararg args: Any?): String
Использует эту строку в качестве строки формата и возвращает строку, полученную путем подстановки указанных аргументов, используя указанный языковой стандарт.
fun String.format(locale: Locale, vararg args: Any?): String
Использует эту строку в качестве строки формата и возвращает строку, полученную путем подстановки указанных аргументов, используя указанный языковой стандарт. Если locale есть null , то локализация не применяется.
fun String.format(locale: Locale?, vararg args: Any?): String
getOrElse
Возвращает символ по заданному индексу или результат вызова функции defaultValue, если индекс находится вне границ этой последовательности символов.
fun CharSequence.getOrElse( index: Int, defaultValue: (Int) -> Char ): Char
getOrNull
Возвращает символ по заданному индексу или null , если индекс находится вне границ этой последовательности символов.
fun CharSequence.getOrNull(index: Int): Char?
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>>
groupByTo
Группирует символы исходной последовательности символов по ключу, возвращаемому заданной функцией keySelector, применённой к каждому символу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих символов.
fun <K, M : MutableMap<in K, MutableList<Char>>> CharSequence.groupByTo( destination: M, keySelector: (Char) -> K ): M
Группирует значения, возвращаемые функцией valueTransform, применённой к каждому символу исходной последовательности символов, по ключу, возвращаемому заданной функцией keySelector, применённой к символу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих значений.
fun <K, V, M : MutableMap<in K, MutableList<V>>> CharSequence.groupByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M
groupingBy
Создаёт источник Grouping из последовательности символов для последующего использования с операциями группировки и сворачивания, используя указанную функцию keySelector для извлечения ключа из каждого символа.
fun <K> CharSequence.groupingBy( keySelector: (Char) -> K ): Grouping<Char, K>
hasSurrogatePairAt
Возвращает true , если в этой последовательности символов есть пара суррогатных символов Юникода по указанному индексу.
fun CharSequence.hasSurrogatePairAt(index: Int): Boolean
ifBlank
Возвращает эту последовательность символов, если она не пуста и не состоит только из пробельных символов, или результат вызова функции defaultValue в противном случае.
fun <C, R> C.ifBlank( defaultValue: () -> R ): R where C : CharSequence, C : R
ifEmpty
Возвращает эту последовательность символов, если она не пустая, или результат вызова функции defaultValue, если последовательность символов пустая.
fun <C, R> C.ifEmpty( defaultValue: () -> R ): R where C : CharSequence, C : R
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
indexOfAny
Находит индекс первого вхождения любого из указанных символов в этой последовательности символов, начиная с указанного начального индекса, и необязательно игнорируя регистр.
fun CharSequence.indexOfAny( chars: CharArray, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
Находит индекс первого вхождения любого из указанных строк в этой последовательности символов, начиная с указанного начального индекса, и необязательно игнорируя регистр.
fun CharSequence.indexOfAny( strings: Collection<String>, startIndex: Int = 0, ignoreCase: Boolean = false ): Int
indexOfFirst
Возвращает индекс первого символа, соответствующего заданному предикату, или -1, если последовательность символов не содержит такого символа.
fun CharSequence.indexOfFirst( predicate: (Char) -> Boolean ): Int
indexOfLast
Возвращает индекс последнего символа, соответствующего заданному предикату, или -1, если последовательность символов не содержит такого символа.
fun CharSequence.indexOfLast( predicate: (Char) -> Boolean ): Int
intern
Возвращает каноническое представление для этого объекта строки.
fun String.intern(): String
isEmpty
Возвращает true если эта последовательность символов пустая (не содержит символов).
fun CharSequence.isEmpty(): Boolean
isNotBlank
Возвращает true если эта последовательность символов не пустая и содержит символы, кроме пробельных.
fun CharSequence.isNotBlank(): Boolean
isNotEmpty
Возвращает true если эта последовательность символов не пустая.
fun CharSequence.isNotEmpty(): Boolean
isNullOrBlank
Возвращает true если эта nullable последовательность символов либо null , либо пустая, либо состоит только из пробельных символов.
fun CharSequence?.isNullOrBlank(): Boolean
isNullOrEmpty
Возвращает true если эта nullable последовательность символов либо null , либо пустая.
fun CharSequence?.isNullOrEmpty(): Boolean
iterator
Итератор для символов заданной последовательности символов.
operator fun CharSequence.iterator(): CharIterator
last
Возвращает последний символ.
fun CharSequence.last(): Char
Возвращает последний символ, соответствующий заданному предикату.
fun CharSequence.last(predicate: (Char) -> Boolean): Char
lastIndexOf
Возвращает индекс последнего вхождения указанного символа в этой последовательности символов, начиная с указанного начального индекса.
fun CharSequence.lastIndexOf( char: Char, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Возвращает индекс последнего вхождения указанной строки в этой последовательности символов, начиная с указанного начального индекса.
fun CharSequence.lastIndexOf( string: String, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
lastIndexOfAny
Находит индекс последнего вхождения любого из указанных символов в этой последовательности символов, начиная с указанного начального индекса и необязательно игнорируя регистр.
fun CharSequence.lastIndexOfAny( chars: CharArray, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
Находит индекс последнего вхождения любого из указанных строк в этой последовательности символов, начиная с указанного начального индекса и необязательно игнорируя регистр.
fun CharSequence.lastIndexOfAny( strings: Collection<String>, startIndex: Int = lastIndex, ignoreCase: Boolean = false ): Int
lastOrNull
Возвращает последний символ или null если последовательность символов пуста.
fun CharSequence.lastOrNull(): Char?
Возвращает последний символ, соответствующий заданному предикату, или null если такой символ не найден.
fun CharSequence.lastOrNull( predicate: (Char) -> Boolean ): Char?
lines
Разделяет эту последовательность символов на список строк, разделённых одной из следующих последовательностей символов: CRLF, LF или CR.
fun CharSequence.lines(): List<String>
lineSequence
Разделяет эту последовательность символов на последовательность строк, разделённых одной из следующих последовательностей символов: CRLF, LF или CR.
fun CharSequence.lineSequence(): Sequence<String>
lowercase
Возвращает копию этой строки, преобразованную в нижний регистр с использованием правил указанной локали.
fun String.lowercase(locale: Locale): String
map
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому символу в исходной последовательности символов.
fun <R> CharSequence.map(transform: (Char) -> R): List<R>
mapIndexed
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому символу и его индексу в исходной последовательности символов.
fun <R> CharSequence.mapIndexed( transform: (index: Int, Char) -> R ): List<R>
mapIndexedNotNull
Возвращает список, содержащий только ненулевые результаты применения заданной функции преобразования к каждому символу и его индексу в исходной последовательности символов.
fun <R : Any> CharSequence.mapIndexedNotNull( transform: (index: Int, Char) -> R? ): List<R>
mapIndexedNotNullTo
Применяет заданную функцию преобразования к каждому символу и его индексу в исходной последовательности символов и добавляет только ненулевые результаты в заданный назначение.
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo( destination: C, transform: (index: Int, Char) -> R? ): C
mapIndexedTo
Применяет заданную функцию преобразования к каждому символу и его индексу в исходной последовательности символов и добавляет результаты в заданный назначение.
fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo( destination: C, transform: (index: Int, Char) -> R ): C
mapNotNull
Возвращает список, содержащий только ненулевые результаты применения заданной функции преобразования к каждому символу в исходной последовательности символов.
fun <R : Any> CharSequence.mapNotNull( transform: (Char) -> R? ): List<R>
mapNotNullTo
Применяет заданную функцию преобразования к каждому символу в исходной последовательности символов и добавляет только ненулевые результаты в заданный назначение.
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapNotNullTo( destination: C, transform: (Char) -> R? ): C
mapTo
Применяет заданную функцию преобразования к каждому символу исходной последовательности символов и добавляет результаты в заданный назначение.
fun <R, C : MutableCollection<in R>> CharSequence.mapTo( destination: C, transform: (Char) -> R ): C
match
fun String.match(regex: String): Array<String>?
matches
Возвращает true если эта последовательность символов соответствует данному регулярному выражению.
infix fun CharSequence.matches(regex: Regex): Boolean
fun String.matches(regex: String): Boolean
max
fun CharSequence.max(): Char?
maxBy
fun <R : Comparable<R>> CharSequence.maxBy( selector: (Char) -> R ): Char?
maxByOrNull
Возвращает первый символ, дающий наибольшее значение заданной функции, или null если символов нет.
fun <R : Comparable<R>> CharSequence.maxByOrNull( selector: (Char) -> R ): Char?
maxOf
Возвращает наибольшее значение среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun <R : Comparable<R>> any_iterable<R>.maxOf( selector: (Char) -> R ): R
maxOfOrNull
Возвращает наибольшее значение среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов, или null если символов нет.
fun <R : Comparable<R>> any_iterable<R>.maxOfOrNull( selector: (Char) -> R ): R?
maxOfWith
Возвращает наибольшее значение по предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun <R> CharSequence.maxOfWith( comparator: Comparator<in R>, selector: (Char) -> R ): R
maxOfWithOrNull
Возвращает наибольшее значение по предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов, или null если символов нет.
fun <R> CharSequence.maxOfWithOrNull( comparator: Comparator<in R>, selector: (Char) -> R ): R?
maxOrNull
Возвращает наибольший символ или null если символов нет.
fun CharSequence.maxOrNull(): Char?
maxWith
fun CharSequence.maxWith( comparator: Comparator<in Char> ): Char?
maxWithOrNull
Возвращает первый символ с наибольшим значением по предоставленному компаратору или null если символов нет.
fun CharSequence.maxWithOrNull( comparator: Comparator<in Char> ): Char?
min
fun CharSequence.min(): Char?
minBy
fun <R : Comparable<R>> CharSequence.minBy( selector: (Char) -> R ): Char?
minByOrNull
Возвращает первый символ, дающий наименьшее значение заданной функции, или null если символов нет.
fun <R : Comparable<R>> CharSequence.minByOrNull( selector: (Char) -> R ): Char?
minOf
Возвращает наименьшее значение среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun <R : Comparable<R>> any_iterable<R>.minOf( selector: (Char) -> R ): R
minOfOrNull
Возвращает наименьшее значение среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов, или null если символов нет.
fun <R : Comparable<R>> any_iterable<R>.minOfOrNull( selector: (Char) -> R ): R?
minOfWith
Возвращает наименьшее значение по предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun <R> CharSequence.minOfWith( comparator: Comparator<in R>, selector: (Char) -> R ): R
minOfWithOrNull
Возвращает наименьшее значение по предоставленному компаратору среди всех значений, полученных функцией выбора, применённой к каждому символу в последовательности символов, или null если символов нет.
fun <R> CharSequence.minOfWithOrNull( comparator: Comparator<in R>, selector: (Char) -> R ): R?
minOrNull
Возвращает наименьший символ или null если символов нет.
fun CharSequence.minOrNull(): Char?
minWith
fun CharSequence.minWith( comparator: Comparator<in Char> ): Char?
minWithOrNull
Возвращает первый символ с наименьшим значением в соответствии с предоставленным компаратором или null если символов нет.
fun CharSequence.minWithOrNull( comparator: Comparator<in Char> ): Char?
none
Возвращает true если в последовательности символов нет символов.
fun CharSequence.none(): Boolean
Возвращает true если ни один символ не соответствует заданному предикату.
fun CharSequence.none(predicate: (Char) -> Boolean): Boolean
offsetByCodePoints
Возвращает индекс в этой строке, смещённый от данного индекса на codePointOffset кодовых точек.
fun String.offsetByCodePoints( index: Int, codePointOffset: Int ): Int
onEach
Выполняет заданное действие для каждого символа и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEach(action: (Char) -> Unit): S
onEachIndexed
Выполняет заданное действие для каждого символа, предоставляя последовательный индекс с символом, и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEachIndexed( action: (index: Int, Char) -> Unit ): S
orEmpty
Возвращает строку, если она не null, иначе — пустую строку.
fun String?.orEmpty(): String
padEnd
Дополняет строку до указанной длины в конце указанным символом или пробелом.
fun String.padEnd(length: Int, padChar: Char = ' '): String
padStart
Дополняет строку до указанной длины в начале указанным символом или пробелом.
fun String.padStart(length: Int, padChar: Char = ' '): String
partition
prependIndent
Добавляет отступ к каждой строке исходной строки.
fun String.prependIndent(indent: String = " "): String
random
Возвращает случайный символ из этой последовательности символов.
fun CharSequence.random(): Char
Возвращает случайный символ из этой последовательности символов, используя указанный источник случайности.
fun CharSequence.random(random: Random): Char
randomOrNull
Возвращает случайный символ из этой последовательности символов или null если эта последовательность символов пуста.
fun CharSequence.randomOrNull(): Char?
Возвращает случайный символ из этой последовательности символов, используя указанный источник случайности, или null если эта последовательность символов пуста.
fun CharSequence.randomOrNull(random: Random): Char?
rangeTo
Создает диапазон от этого значения Comparable до указанного значения that.
operator fun <T : Comparable<T>> T.rangeTo( that: T ): ClosedRange<T>
reader
Создает новый reader для строки.
fun String.reader(): StringReader
reduce
Накапливает значение, начиная с первого символа и применяя operation слева направо к текущему значению накопителя и каждому символу.
fun CharSequence.reduce( operation: (acc: Char, Char) -> Char ): Char
reduceIndexed
Накапливает значение, начиная с первого символа и применяя operation слева направо к текущему значению накопителя и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): Char
reduceIndexedOrNull
Накапливает значение, начиная с первого символа и применяя operation слева направо к текущему значению накопителя и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexedOrNull( operation: (index: Int, acc: Char, Char) -> Char ): Char?
reduceOrNull
Накапливает значение, начиная с первого символа и применяя operation слева направо к текущему значению накопителя и каждому символу.
fun CharSequence.reduceOrNull( operation: (acc: Char, Char) -> Char ): Char?
reduceRight
Накапливает значение, начиная с последнего символа и применяя operation справа налево к каждому символу и текущему значению накопителя.
fun CharSequence.reduceRight( operation: (Char, acc: Char) -> Char ): Char
reduceRightIndexed
Накапливает значение, начиная с последнего символа и применяя operation справа налево к каждому символу с его индексом в исходной последовательности символов и текущему значению накопителя.
fun CharSequence.reduceRightIndexed( operation: (index: Int, Char, acc: Char) -> Char ): Char
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего символа и применяя operation справа налево к каждому символу с его индексом в исходной последовательности символов и текущему значению накопителя.
fun CharSequence.reduceRightIndexedOrNull( operation: (index: Int, Char, acc: Char) -> Char ): Char?
reduceRightOrNull
Накапливает значение, начиная с последнего символа и применяя operation справа налево к каждому символу и текущему значению накопителя.
fun CharSequence.reduceRightOrNull( operation: (Char, acc: Char) -> Char ): Char?
refTo
fun String.refTo(index: Int): CValuesRef<COpaque>
removePrefix
Если эта строка начинается с заданного prefix, возвращает копию этой строки с удаленным префиксом. В противном случае возвращает эту строку.
fun String.removePrefix(prefix: CharSequence): String
removeRange
Удаляет часть строки в заданном диапазоне.
fun String.removeRange( startIndex: Int, endIndex: Int ): String
Удаляет часть строки в заданном range.
fun String.removeRange(range: IntRange): String
removeSuffix
Если эта строка заканчивается заданным suffix, возвращает копию этой строки с удаленным суффиксом. В противном случае возвращает эту строку.
fun String.removeSuffix(suffix: CharSequence): String
removeSurrounding
Удаляет из строки как заданный префикс, так и суффикс, если и только если она начинается с префикса и заканчивается суффиксом. В противном случае возвращает эту строку без изменений.
fun String.removeSurrounding( prefix: CharSequence, suffix: CharSequence ): String
Удаляет заданную строку-разделитель с начала и конца этой строки, если и только если она начинается и заканчивается разделителем. В противном случае возвращает эту строку без изменений.
fun String.removeSurrounding(delimiter: CharSequence): String
replace
Возвращает новую строку, полученную путем замены каждого подстроки этого набора символов, которая соответствует заданному регулярному выражению, заданным заменой.
fun CharSequence.replace( regex: Regex, replacement: String ): String
Возвращает новую строку, полученную путем замены каждой подстроки этого набора символов, которая соответствует заданному регулярному выражению, результатом заданной функции преобразования, которая принимает MatchResult и возвращает строку, которая будет использована в качестве замены для этой совпадения.
fun CharSequence.replace( regex: Regex, transform: (MatchResult) -> CharSequence ): String
replaceAfter
Заменить часть строки после первого вхождения заданного разделителя на строку-замены. Если строка не содержит разделитель, возвращается missingDelimiterValue, по умолчанию – исходная строка.
fun String.replaceAfter( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceAfter( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
replaceAfterLast
Заменить часть строки после последнего вхождения заданного разделителя на строку-замены. Если строка не содержит разделитель, возвращается missingDelimiterValue, по умолчанию – исходная строка.
fun String.replaceAfterLast( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceAfterLast( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
replaceBefore
Заменить часть строки перед первым вхождением заданного разделителя на строку-замены. Если строка не содержит разделитель, возвращается missingDelimiterValue, по умолчанию – исходная строка.
fun String.replaceBefore( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceBefore( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
replaceBeforeLast
Заменить часть строки перед последним вхождением заданного разделителя на строку-замены. Если строка не содержит разделитель, возвращается missingDelimiterValue, по умолчанию – исходная строка.
fun String.replaceBeforeLast( delimiter: Char, replacement: String, missingDelimiterValue: String = this ): String
fun String.replaceBeforeLast( delimiter: String, replacement: String, missingDelimiterValue: String = this ): String
replaceFirst
replaceFirstChar
Возвращает копию этой строки, в которой первый символ заменён результатом заданного преобразования, или исходную строку, если она пустая.
fun String.replaceFirstChar( transform: (Char) -> Char ): String
fun String.replaceFirstChar( transform: (Char) -> CharSequence ): String
replaceIndent
Обнаруживает общий минимальный отступ, как и trimIndent, и заменяет его указанным newIndent.
fun String.replaceIndent(newIndent: String = ""): String
replaceIndentByMargin
Обнаруживает отступ по marginPrefix, как и trimMargin, и заменяет его на newIndent.
fun String.replaceIndentByMargin( newIndent: String = "", marginPrefix: String = "|" ): String
replaceRange
Заменяет часть строки в указанном диапазоне на замещающую последовательность символов.
fun String.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): String
Заменяет часть строки в указанном диапазоне на замещающую строку.
fun String.replaceRange( range: IntRange, replacement: CharSequence ): String
reversed
Возвращает строку с символами в обратном порядке.
fun String.reversed(): String
runningFold
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу и текущему значению накопителя, которое начинается со значения initial.
fun <R> CharSequence.runningFold( initial: R, operation: (acc: R, Char) -> R ): List<R>
runningFoldIndexed
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу, его индексу в исходной последовательности символов и текущему значению накопителя, которое начинается со значения initial.
fun <R> CharSequence.runningFoldIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): List<R>
runningReduce
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу и текущему значению накопителя, которое начинается с первого символа этой последовательности символов.
fun CharSequence.runningReduce( operation: (acc: Char, Char) -> Char ): List<Char>
runningReduceIndexed
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу, его индексу в исходной последовательности символов и текущему значению накопителя, которое начинается с первого символа этой последовательности символов.
fun CharSequence.runningReduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): List<Char>
scan
scanIndexed
Возвращает список, содержащий последовательные значения накопления, сгенерированные путем применения операции слева направо к каждому символу, его индексу в исходной последовательности символов и текущему значению накопителя, которое начинается со значения initial.
fun <R> CharSequence.scanIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): List<R>
single
Возвращает единственный символ или вызывает исключение, если последовательность символов пуста или содержит более одного символа.
fun CharSequence.single(): Char
Возвращает единственный символ, соответствующий заданному предикату, или вызывает исключение, если нет или более одного совпадающего символа.
fun CharSequence.single(predicate: (Char) -> Boolean): Char
singleOrNull
Возвращает единственный символ или null если последовательность символов пуста или содержит более одного символа.
fun CharSequence.singleOrNull(): Char?
Возвращает единственный символ, соответствующий заданному предикату, или null если символ не найден или найдено более одного символа.
fun CharSequence.singleOrNull( predicate: (Char) -> Boolean ): Char?
slice
Возвращает строку, содержащую символы исходной строки в указанном диапазоне индексов.
fun String.slice(indices: IntRange): String
Возвращает строку, содержащую символы исходной строки по указанным индексам.
fun String.slice(indices: Iterable<Int>): String
разделение
Разделяет эту последовательность символов на список строк вокруг вхождений указанных разделителей.
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>
Разделяет эту последовательность символов на список строк вокруг совпадений с заданным регулярным выражением.
fun CharSequence.split( regex: Regex, limit: Int = 0 ): List<String>
Разделяет эту последовательность символов вокруг совпадений с заданным регулярным выражением.
fun CharSequence.split( regex: Pattern, limit: Int = 0 ): List<String>
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>
начинается с
Возвращает 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
подпоследовательность
Возвращает подпоследовательность этой последовательности символов.
fun String.subSequence(start: Int, end: Int): CharSequence
Возвращает подпоследовательность этой последовательности символов, определяемую заданным диапазоном индексов.
fun CharSequence.subSequence(range: IntRange): CharSequence
подстрока
Возвращает подстроку, заданную заданным диапазоном индексов.
fun String.substring(range: IntRange): String
подстрокаПосле
Возвращает подстроку после первого вхождения разделителя. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равный исходной строке.
fun String.substringAfter( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringAfter( delimiter: String, missingDelimiterValue: String = this ): String
подстрокаПослеПоследнего
Возвращает подстроку после последнего вхождения разделителя. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равный исходной строке.
fun String.substringAfterLast( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringAfterLast( delimiter: String, missingDelimiterValue: String = this ): String
подстрокаПеред
Возвращает подстроку перед первым вхождением разделителя. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равный исходной строке.
fun String.substringBefore( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringBefore( delimiter: String, missingDelimiterValue: String = this ): String
подстрокаПередПоследним
Возвращает подстроку перед последним вхождением разделителя. Если строка не содержит разделитель, возвращает missingDelimiterValue, по умолчанию равный исходной строке.
fun String.substringBeforeLast( delimiter: Char, missingDelimiterValue: String = this ): String
fun String.substringBeforeLast( delimiter: String, missingDelimiterValue: String = this ): String
суммаПо
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun CharSequence.sumBy(selector: (Char) -> Int): Int
суммаПоDouble
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому символу в последовательности символов.
fun CharSequence.sumByDouble( selector: (Char) -> Double ): Double
sumOf
Возвращает сумму всех значений, полученных с помощью функции selector, примененной к каждому символу в последовательности символов.
fun CharSequence.sumOf(selector: (Char) -> Double): Double
fun CharSequence.sumOf(selector: (Char) -> Int): Int
fun CharSequence.sumOf(selector: (Char) -> Long): Long
fun CharSequence.sumOf(selector: (Char) -> UInt): UInt
fun CharSequence.sumOf(selector: (Char) -> ULong): ULong
fun CharSequence.sumOf( selector: (Char) -> BigDecimal ): BigDecimal
fun CharSequence.sumOf( selector: (Char) -> BigInteger ): BigInteger
take
Возвращает строку, содержащую первые n символов из этой строки, или всю строку, если эта строка короче.
fun String.take(n: Int): String
takeLast
Возвращает строку, содержащую последние n символов из этой строки, или всю строку, если эта строка короче.
fun String.takeLast(n: Int): String
takeLastWhile
Возвращает строку, содержащую последние символы, удовлетворяющие заданному predicate.
fun String.takeLastWhile( predicate: (Char) -> Boolean ): String
takeWhile
Возвращает строку, содержащую первые символы, удовлетворяющие заданному predicate.
fun String.takeWhile(predicate: (Char) -> Boolean): String
toBigDecimal
Разбирает строку как число java.math.BigDecimal и возвращает результат.
fun String.toBigDecimal(): BigDecimal
fun String.toBigDecimal(mathContext: MathContext): BigDecimal
toBigDecimalOrNull
Разбирает строку как число java.math.BigDecimal и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toBigDecimalOrNull(): BigDecimal?
fun String.toBigDecimalOrNull( mathContext: MathContext ): BigDecimal?
toBigInteger
Разбирает строку как число java.math.BigInteger и возвращает результат.
fun String.toBigInteger(): BigInteger
fun String.toBigInteger(radix: Int): BigInteger
toBigIntegerOrNull
Разбирает строку как число java.math.BigInteger и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toBigIntegerOrNull(): BigInteger?
fun String.toBigIntegerOrNull(radix: Int): BigInteger?
toBooleanStrict
Возвращает true если содержимое этой строки равно слову "true", false если оно равно "false", и вызывает исключение в противном случае.
fun String.toBooleanStrict(): Boolean
toBooleanStrictOrNull
Возвращает true если содержимое этой строки равно слову "true", false если оно равно "false", и null в противном случае.
fun String.toBooleanStrictOrNull(): Boolean?
toByteArray
Кодирует содержимое этой строки с использованием указанной кодировки символов и возвращает результирующий массив байтов.
fun String.toByteArray( charset: Charset = Charsets.UTF_8 ): ByteArray
toByteOrNull
Разбирает строку как знаковое число Byte и возвращает результат или null если строка не является допустимым представлением числа.
fun String.toByteOrNull(): Byte?
fun String.toByteOrNull(radix: Int): Byte?
toCharArray
Копирует символы из этой строки в массив символов destination и возвращает этот массив.
fun String.toCharArray( destination: CharArray, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = length ): CharArray
toCollection
Добавляет все символы в заданную коллекцию destination.
fun <C : MutableCollection<in Char>> CharSequence.toCollection( destination: C ): C
toHashSet
Возвращает новый HashSet всех символов.
fun CharSequence.toHashSet(): HashSet<Char>
toIntOrNull
Парсит строку как число типа Int и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toIntOrNull(): Int?
fun String.toIntOrNull(radix: Int): Int?
toList
Возвращает List, содержащую все символы.
fun CharSequence.toList(): List<Char>
toLongOrNull
Парсит строку как число типа Long и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toLongOrNull(): Long?
fun String.toLongOrNull(radix: Int): Long?
toLowerCase
Возвращает копию этой строки, преобразованной в нижний регистр, используя правила указанного языка.
fun String.toLowerCase(locale: Locale): String
toMutableList
Возвращает новый MutableList, заполненный всеми символами этой последовательности символов.
fun CharSequence.toMutableList(): MutableList<Char>
toPattern
toRegex
Преобразует строку в регулярное выражение Regex с опциями по умолчанию.
fun String.toRegex(): Regex
Преобразует строку в регулярное выражение Regex с указанной опцией.
fun String.toRegex(option: RegexOption): Regex
Преобразует строку в регулярное выражение Regex с указанным набором опций.
fun String.toRegex(options: Set<RegexOption>): Regex
toSet
Возвращает Set всех символов.
fun CharSequence.toSet(): Set<Char>
toShortOrNull
Парсит строку как число типа Short и возвращает результат или null , если строка не является допустимым представлением числа.
fun String.toShortOrNull(): Short?
fun String.toShortOrNull(radix: Int): Short?
toSortedSet
Возвращает новый SortedSet всех символов.
fun CharSequence.toSortedSet(): SortedSet<Char>
toULong
Парсит строку как число ULong и возвращает результат.
fun String.toULong(): ULong
fun String.toULong(radix: Int): ULong
toULongOrNull
Парсит строку как число ULong и возвращает результат или null если строка не является корректным представлением числа.
fun String.toULongOrNull(): ULong?
fun String.toULongOrNull(radix: Int): ULong?
toUpperCase
Возвращает копию этой строки, преобразованную в верхний регистр по правилам указанного языка.
fun String.toUpperCase(locale: Locale): String
toUShort
Парсит строку как число UShort и возвращает результат.
fun String.toUShort(): UShort
fun String.toUShort(radix: Int): UShort
toUShortOrNull
Парсит строку как число UShort и возвращает результат или null если строка не является корректным представлением числа.
fun String.toUShortOrNull(): UShort?
fun String.toUShortOrNull(radix: Int): UShort?
trim
Возвращает строку, из которой удалены начальные и конечные символы, соответствующие предикату.
fun String.trim(predicate: (Char) -> Boolean): String
Возвращает строку, из которой удалены начальные и конечные символы из массива chars.
fun String.trim(vararg chars: Char): String
Возвращает строку, из которой удалены начальные и конечные пробелы.
fun String.trim(): String
trimEnd
Возвращает строку, из которой удалены конечные символы, соответствующие предикату.
fun String.trimEnd(predicate: (Char) -> Boolean): String
Возвращает строку, из которой удалены конечные символы из массива chars.
fun String.trimEnd(vararg chars: Char): String
Возвращает строку, из которой удалены конечные пробелы.
fun String.trimEnd(): String
trimIndent
Определяет минимальный общий отступ всех строк ввода, удаляет его из каждой строки, а также удаляет первую и последнюю строки, если они пусты (обратите внимание на разницу между пустой и пустой строкой).
fun String.trimIndent(): String
trimMargin
Удаляет начальные пробельные символы, за которыми следует marginPrefix из каждой строки исходной строки и удаляет первую и последнюю строки, если они пусты (обратите внимание на разницу между пустой и пустой строкой).
fun String.trimMargin(marginPrefix: String = "|"): String
trimStart
Возвращает строку, из которой удалены начальные символы, соответствующие предикату.
fun String.trimStart(predicate: (Char) -> Boolean): String
Возвращает строку, из которой удалены начальные символы из массива chars.
fun String.trimStart(vararg chars: Char): String
Возвращает строку, из которой удалены начальные пробелы.
fun String.trimStart(): String
uppercase
Возвращает копию этой строки, преобразованную в верхний регистр по правилам указанного языка.
fun String.uppercase(locale: Locale): String
windowed
Возвращает список снимков окна заданного размера size, скользящего по этому набору символов с заданным шагом, где каждый снимок — строка.
fun CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false ): List<String>
Возвращает список результатов применения заданной функции преобразования к каждому набору символов, представляющему вид на окно заданного размера size, скользящего по этому набору символов с заданным шагом.
fun <R> CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (CharSequence) -> R ): List<R>
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>
withIndex
Возвращает ленивый Iterable, который оборачивает каждый символ исходной последовательности символов в IndexedValue, содержащий индекс этого символа и сам символ.
fun CharSequence.withIndex(): Iterable<IndexedValue<Char>>
zip
Возвращает список пар, составленных из символов this и последовательностей символов other с одинаковым индексом. Возвращаемый список имеет длину кратчайшей последовательности символов.
infix fun CharSequence.zip( other: CharSequence ): List<Pair<Char, Char>>
Возвращает список значений, составленных из символов this и последовательностей символов other с одинаковым индексом с использованием предоставленной функции преобразования, примененной к каждой паре символов. Возвращаемый список имеет длину кратчайшей последовательности символов.
fun <V> CharSequence.zip( other: CharSequence, transform: (a: Char, b: Char) -> V ): List<V>
zipWithNext
Возвращает список пар из двух соседних символов в этой последовательности символов.
fun CharSequence.zipWithNext(): List<Pair<Char, Char>>
Возвращает список, содержащий результаты применения заданной функции преобразования к каждой паре двух соседних символов в этой последовательности символов.
fun <R> CharSequence.zipWithNext( transform: (a: Char, b: Char) -> R ): List<R>
Расширяющие функции объекта-компаньона
format
Использует предоставленный формат в качестве строки формата и возвращает строку, полученную путем подстановки указанных аргументов, используя локаль по умолчанию.
fun String.Companion.format( format: String, vararg args: Any? ): String
Использует предоставленный формат в качестве строки формата и возвращает строку, полученную путем подстановки указанных аргументов, используя указанную локаль.
fun String.Companion.format( locale: Locale, format: String, vararg args: Any? ): String
Использует предоставленный формат в качестве строки формата и возвращает строку, полученную путем подстановки указанных аргументов, используя указанную локаль. Если локаль равна null , то никакая локализация не применяется.
fun String.Companion.format( locale: Locale?, format: String, vararg args: Any? ): String
© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html