CharSequence
interface CharSequence
Представляет читаемую последовательность значений Char.
Свойства
length
Возвращает длину этой последовательности символов.
abstract val length: Int
Функции
get
Возвращает символ в указанном индексе в этой последовательности символов.
abstract operator fun get(index: Int): Char
subSequence
Возвращает новую последовательность символов, являющуюся подпоследовательностью этой последовательности символов, начиная с указанного startIndex и заканчивая значением, предшествующим указанному endIndex.
abstract fun subSequence( startIndex: Int, endIndex: Int ): CharSequence
Расширяемые свойства
indices
Возвращает диапазон допустимых индексов символов для этой последовательности символов.
val CharSequence.indices: IntRange
lastIndex
Возвращает индекс последнего символа в последовательности символов или -1, если она пуста.
val CharSequence.lastIndex: Int
Расширяемые функции
все
Возвращает true если все символы соответствуют заданному предикату.
fun CharSequence.all(predicate: (Char) -> Boolean): Boolean
любой
Возвращает 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
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, применённой к каждому символу заданной последовательности символов, а значением является сам символ.
fun <K, M : MutableMap<in K, in Char>> CharSequence.associateByTo( destination: M, keySelector: (Char) -> K ): M
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, а значение предоставляется функцией valueTransform, применёнными к символам заданной последовательности символов.
fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M
associateTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, полученными от функции transform, применённой к каждому символу заданной последовательности символов.
fun <K, V, M : MutableMap<in K, in V>> CharSequence.associateTo( destination: M, transform: (Char) -> Pair<K, V> ): M
associateWith
Возвращает Map, где ключами являются символы из заданной последовательности символов, а значения производятся функцией valueSelector, применённой к каждому символу.
fun <V> CharSequence.associateWith( valueSelector: (Char) -> V ): Map<Char, V>
associateWithTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение для каждого символа из заданной последовательности символов, где ключом является сам символ, а значением является результат применения функции valueSelector к этому ключу.
fun <V, M : MutableMap<in Char, in V>> CharSequence.associateWithTo( destination: M, valueSelector: (Char) -> V ): M
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>
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
contains
Возвращает true, если эта последовательность символов содержит указанную последовательность символов other в качестве подстроки.
operator fun CharSequence.contains( other: CharSequence, ignoreCase: Boolean = false ): Boolean
Возвращает true, если эта последовательность символов содержит указанный символ char.
operator fun CharSequence.contains( char: Char, ignoreCase: Boolean = false ): Boolean
Возвращает true, если эта последовательность символов содержит хотя бы одно совпадение с указанным регулярным выражением regex.
operator fun CharSequence.contains(regex: Regex): Boolean
drop
Возвращает подпоследовательность этой последовательности символов с удаленными первыми n символами.
fun CharSequence.drop(n: Int): CharSequence
dropLast
Возвращает подпоследовательность этой последовательности символов с удаленными последними n символами.
fun CharSequence.dropLast(n: Int): CharSequence
dropLastWhile
Возвращает подпоследовательность этой последовательности символов, содержащую все символы, кроме последних символов, удовлетворяющих заданному предикату.
fun CharSequence.dropLastWhile( predicate: (Char) -> Boolean ): CharSequence
dropWhile
Возвращает подпоследовательность этой последовательности символов, содержащую все символы, кроме первых символов, удовлетворяющих заданному предикату.
fun CharSequence.dropWhile( predicate: (Char) -> Boolean ): CharSequence
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 CharSequence.filter( predicate: (Char) -> Boolean ): CharSequence
filterIndexed
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые соответствуют заданному предикату.
fun CharSequence.filterIndexed( predicate: (index: Int, Char) -> Boolean ): CharSequence
filterIndexedTo
Добавляет все символы, соответствующие заданному предикату, в заданный destination.
fun <C : Appendable> CharSequence.filterIndexedTo( destination: C, predicate: (index: Int, Char) -> Boolean ): C
filterNot
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые не соответствуют заданному предикату.
fun CharSequence.filterNot( predicate: (Char) -> Boolean ): CharSequence
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>?
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
Накапливает значение, начиная с начального значения и применяя операцию слева направо к текущему значению накопителя и каждому символу.
fun <R> CharSequence.fold( initial: R, operation: (acc: R, Char) -> R ): R
foldIndexed
Накапливает значение, начиная с начального значения и применяя операцию слева направо к текущему значению накопителя и каждому символу с его индексом в исходной последовательности символов.
fun <R> CharSequence.foldIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): R
foldRight
Накапливает значение, начиная с начального значения и применяя операцию справа налево к каждому символу и текущему значению накопителя.
fun <R> CharSequence.foldRight( initial: R, operation: (Char, acc: R) -> R ): R
foldRightIndexed
Накапливает значение, начиная с начального значения и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущему значению накопителя.
fun <R> CharSequence.foldRightIndexed( initial: R, operation: (index: Int, Char, acc: R) -> R ): R
forEach
Выполняет заданное действие для каждого символа.
fun CharSequence.forEach(action: (Char) -> Unit)
forEachIndexed
Выполняет заданное действие для каждого символа, предоставляя порядковый индекс с символом.
fun CharSequence.forEachIndexed( action: (index: Int, Char) -> Unit)
getOrElse
Возвращает символ по заданному индексу или результат вызова функции defaultValue, если индекс находится за пределами этой последовательности символов.
fun CharSequence.getOrElse( index: Int, defaultValue: (Int) -> Char ): Char
getOrNull
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
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
Находит индекс первого вхождения любого из указанных символов в этой последовательности символов, начиная с указанного 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
indexOfFirst
Возвращает индекс первого символа, удовлетворяющего заданному предикату, или -1, если такая последовательность символов отсутствует.
fun CharSequence.indexOfFirst( predicate: (Char) -> Boolean ): Int
indexOfLast
Возвращает индекс последнего символа, удовлетворяющего заданному предикату, или -1, если такая последовательность символов отсутствует.
fun CharSequence.indexOfLast( predicate: (Char) -> Boolean ): Int
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
Возвращает индекс в этой последовательности символов последнего вхождения указанного символа, начиная с указанного 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
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
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>
map
Возвращает список, содержащий результаты применения заданной transform функции к каждому символу в исходной последовательности символов.
fun <R> CharSequence.map(transform: (Char) -> R): List<R>
mapIndexed
Возвращает список, содержащий результаты применения заданной transform функции к каждому символу и его индексу в исходной последовательности символов.
fun <R> CharSequence.mapIndexed( transform: (index: Int, Char) -> R ): List<R>
mapIndexedNotNull
Возвращает список, содержащий только те результаты, которые не равны null, полученные при применении заданной функции transform к каждому символу и его индексу в исходной последовательности символов.
fun <R : Any> CharSequence.mapIndexedNotNull( transform: (index: Int, Char) -> R? ): List<R>
mapIndexedNotNullTo
Применяет заданную функцию transform к каждому символу и его индексу в исходной последовательности символов и добавляет только результаты, не равные null, в заданное место назначения .
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapIndexedNotNullTo( destination: C, transform: (index: Int, Char) -> R? ): C
mapIndexedTo
Применяет заданную функцию transform к каждому символу и его индексу в исходной последовательности символов и добавляет результаты в заданное место назначения .
fun <R, C : MutableCollection<in R>> CharSequence.mapIndexedTo( destination: C, transform: (index: Int, Char) -> R ): C
mapNotNull
Возвращает список, содержащий только те результаты, которые не равны null, полученные при применении заданной функции transform к каждому символу в исходной последовательности символов.
fun <R : Any> CharSequence.mapNotNull( transform: (Char) -> R? ): List<R>
mapNotNullTo
Применяет заданную функцию transform к каждому символу в исходной последовательности символов и добавляет только результаты, не равные null, в заданное место назначения .
fun <R : Any, C : MutableCollection<in R>> CharSequence.mapNotNullTo( destination: C, transform: (Char) -> R? ): C
mapTo
Применяет заданную функцию transform к каждому символу исходной последовательности символов и добавляет результаты в заданное место назначения .
fun <R, C : MutableCollection<in R>> CharSequence.mapTo( destination: C, transform: (Char) -> R ): C
matches
Возвращает true если эта последовательность символов соответствует заданному регулярному выражению.
infix fun CharSequence.matches(regex: Regex): 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
Возвращает наибольшее значение в соответствии с предоставленным comparator среди всех значений, полученных с помощью функции 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
Возвращает первый символ, имеющий наибольшее значение в соответствии с предоставленным comparator или 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
Возвращает наименьшее значение в соответствии с предоставленным comparator среди всех значений, полученных с помощью функции selector, примененной к каждому символу в последовательности символов.
fun <R> CharSequence.minOfWith( comparator: Comparator<in R>, selector: (Char) -> R ): R
minOfWithOrNull
Возвращает наименьшее значение в соответствии с предоставленным comparator среди всех значений, полученных с помощью функции selector, примененной к каждому символу в последовательности символов, или 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
Возвращает первый символ, имеющий наименьшее значение в соответствии с предоставленным comparator или null если символов нет.
fun CharSequence.minWithOrNull( comparator: Comparator<in Char> ): Char?
none
Возвращает true если последовательность символов не содержит символов.
fun CharSequence.none(): Boolean
Возвращает true если ни один символ не соответствует заданному predicate.
fun CharSequence.none(predicate: (Char) -> Boolean): Boolean
onEach
Выполняет заданное действие над каждым символом и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEach(action: (Char) -> Unit): S
onEachIndexed
Выполняет заданное действие над каждым символом, предоставляя последовательный индекс с символом, и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEachIndexed( action: (index: Int, Char) -> Unit ): S
padEnd
Возвращает последовательность символов с содержимым этой последовательности символов, дополненным справа до указанной длины указанным символом или пробелом.
fun CharSequence.padEnd( length: Int, padChar: Char = ' ' ): CharSequence
padStart
Возвращает последовательность символов с содержимым этой последовательности символов, дополненным в начале до указанной длины указанным символом или пробелом.
fun CharSequence.padStart( length: Int, padChar: Char = ' ' ): CharSequence
partition
Разделяет исходную последовательность символов на пару последовательностей символов, где последовательность символов first содержит символы, для которых предикат возвратил true, а последовательность символов second содержит символы, для которых предикат возвратил false.
fun CharSequence.partition( predicate: (Char) -> Boolean ): Pair<CharSequence, CharSequence>
random
Возвращает случайный символ из этой последовательности символов.
fun CharSequence.random(): Char
Возвращает случайный символ из этой последовательности символов, используя указанный источник случайности.
fun CharSequence.random(random: Random): Char
randomOrNull
Возвращает случайный символ из этой последовательности символов или null , если эта последовательность символов пуста.
fun CharSequence.randomOrNull(): Char?
Возвращает случайный символ из этой последовательности символов, используя указанный источник случайности, или null , если эта последовательность символов пуста.
fun CharSequence.randomOrNull(random: Random): Char?
reduce
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению накопителя и каждому символу.
fun CharSequence.reduce( operation: (acc: Char, Char) -> Char ): Char
reduceIndexed
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению накопителя и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): Char
reduceIndexedOrNull
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению накопителя и каждому символу с его индексом в исходной последовательности символов.
fun CharSequence.reduceIndexedOrNull( operation: (index: Int, acc: Char, Char) -> Char ): Char?
reduceOrNull
Накапливает значение, начиная с первого символа и применяя операцию слева направо к текущему значению накопителя и каждому символу.
fun CharSequence.reduceOrNull( operation: (acc: Char, Char) -> Char ): Char?
reduceRight
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу и текущему значению накопителя.
fun CharSequence.reduceRight( operation: (Char, acc: Char) -> Char ): Char
reduceRightIndexed
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущему значению накопителя.
fun CharSequence.reduceRightIndexed( operation: (index: Int, Char, acc: Char) -> Char ): Char
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего символа и применяя операцию справа налево к каждому символу с его индексом в исходной последовательности символов и текущему значению накопителя.
fun CharSequence.reduceRightIndexedOrNull( operation: (index: Int, Char, acc: Char) -> Char ): Char?
reduceRightOrNull
Накапливает значение, начиная с последнего символа, применяя операцию справа налево к каждому символу и текущему значению аккумулятора.
fun CharSequence.reduceRightOrNull( operation: (Char, acc: Char) -> Char ): Char?
removePrefix
Если эта последовательность символов начинается с заданного префикса, возвращает новую последовательность символов без префикса. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removePrefix( prefix: CharSequence ): CharSequence
removeRange
Возвращает последовательность символов с содержимым этой последовательности символов, где ее часть в заданном диапазоне удалена.
fun CharSequence.removeRange( startIndex: Int, endIndex: Int ): CharSequence
Возвращает последовательность символов с содержимым этой последовательности символов, где ее часть в заданном диапазоне удалена.
fun CharSequence.removeRange(range: IntRange): CharSequence
removeSuffix
Если эта последовательность символов заканчивается заданным суффиксом, возвращает новую последовательность символов без суффикса. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSuffix( suffix: CharSequence ): CharSequence
removeSurrounding
Если эта последовательность символов начинается с заданного префикса и заканчивается заданным суффиксом, возвращает новую последовательность символов, у которой удалены оба заданных префикс и суффикс. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSurrounding( prefix: CharSequence, suffix: CharSequence ): CharSequence
Если эта последовательность символов начинается и заканчивается заданным разделителем, возвращает новую последовательность символов, у которой удален этот разделитель с начала и конца. В противном случае возвращает новую последовательность символов с теми же символами.
fun CharSequence.removeSurrounding( delimiter: CharSequence ): CharSequence
replace
Возвращает новую строку, полученную заменой каждой подстроки этой последовательности символов, которая соответствует заданному регулярному выражению, заданной заменой.
fun CharSequence.replace( regex: Regex, replacement: String ): String
Возвращает новую строку, полученную заменой каждой подстроки этой последовательности символов, которая соответствует заданному регулярному выражению, результатом заданной функции преобразования, которая принимает MatchResult и возвращает строку, используемую в качестве замены для этого совпадения.
fun CharSequence.replace( regex: Regex, transform: (MatchResult) -> CharSequence ): String
replaceFirst
Заменяет первое вхождение заданного регулярного выражения regex в этой последовательности символов указанным замещением.
fun CharSequence.replaceFirst( regex: Regex, replacement: String ): String
replaceRange
Возвращает последовательность символов с содержимым этой последовательности символов, где ее часть в заданном диапазоне заменена на замену последовательность символов.
fun CharSequence.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): CharSequence
reversed
Возвращает последовательность символов с символами в обратном порядке.
fun CharSequence.reversed(): CharSequence
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>
scanReduce
fun CharSequence.scanReduce( operation: (acc: Char, Char) -> Char ): List<Char>
scanReduceIndexed
fun CharSequence.scanReduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): List<Char>
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 CharSequence.slice(indices: IntRange): CharSequence
Возвращает последовательность символов, содержащую символы исходной последовательности символов по указанным индексам.
fun CharSequence.slice(indices: Iterable<Int>): CharSequence
split
Разделяет эту последовательность символов на список строк вокруг вхождений указанных разделителей.
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>
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
subSequence
Возвращает подпоследовательность этой последовательности символов, определяемой заданным диапазоном индексов.
fun CharSequence.subSequence(range: IntRange): CharSequence
substring
Возвращает подстроку символов из диапазона этой последовательности символов, начинающейся с startIndex и заканчивающейся прямо перед endIndex.
fun CharSequence.substring( startIndex: Int, endIndex: Int = length ): String
Возвращает подстроку символов в индексах из указанного диапазона этой последовательности символов.
fun CharSequence.substring(range: IntRange): String
sumBy
Возвращает сумму всех значений, полученных в результате применения функции selector к каждому символу в последовательности символов.
fun CharSequence.sumBy(selector: (Char) -> Int): Int
sumByDouble
Возвращает сумму всех значений, полученных в результате применения функции 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 CharSequence.take(n: Int): CharSequence
takeLast
Возвращает подпоследовательность этой последовательности символов, содержащую последние n символов из этой последовательности символов или всю последовательность символов, если эта последовательность символов короче.
fun CharSequence.takeLast(n: Int): CharSequence
takeLastWhile
Возвращает подпоследовательность этой последовательности символов, содержащую последние символы, которые удовлетворяют заданному предикату.
fun CharSequence.takeLastWhile( predicate: (Char) -> Boolean ): CharSequence
takeWhile
Возвращает подпоследовательность этой последовательности символов, содержащую первые символы, которые удовлетворяют заданному предикату.
fun CharSequence.takeWhile( predicate: (Char) -> Boolean ): CharSequence
toCollection
Добавляет все символы в заданную коллекцию назначения.
fun <C : MutableCollection<in Char>> CharSequence.toCollection( destination: C ): C
toHashSet
Возвращает новый HashSet всех символов.
fun CharSequence.toHashSet(): HashSet<Char>
toList
Возвращает List, содержащий все символы.
fun CharSequence.toList(): List<Char>
toMutableList
Возвращает новый MutableList, заполненный всеми символами этой последовательности символов.
fun CharSequence.toMutableList(): MutableList<Char>
toSet
Возвращает Set всех символов.
fun CharSequence.toSet(): Set<Char>
toSortedSet
Возвращает новый SortedSet всех символов.
fun CharSequence.toSortedSet(): SortedSet<Char>
trim
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные и конечные символы, соответствующие предикату.
fun CharSequence.trim( predicate: (Char) -> Boolean ): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные и конечные символы из массива chars.
fun CharSequence.trim(vararg chars: Char): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные и конечные пробелы.
fun CharSequence.trim(): CharSequence
trimEnd
Возвращает подпоследовательность этой последовательности символов, у которой удалены конечные символы, соответствующие предикату.
fun CharSequence.trimEnd( predicate: (Char) -> Boolean ): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены конечные символы из массива chars.
fun CharSequence.trimEnd(vararg chars: Char): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены конечные пробелы.
fun CharSequence.trimEnd(): CharSequence
trimStart
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные символы, соответствующие предикату.
fun CharSequence.trimStart( predicate: (Char) -> Boolean ): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные символы из массива chars.
fun CharSequence.trimStart(vararg chars: Char): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены начальные пробелы.
fun CharSequence.trimStart(): CharSequence
windowed
Возвращает список снимков окна заданного размера size, скользящего по этой последовательности символов с заданным шагом step, где каждый снимок — строка.
fun CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false ): List<String>
Возвращает список результатов применения заданной функции трансформации transform к каждой последовательности символов, представляющей представление окна заданного размера size, скользящего по этой последовательности символов с заданным шагом step.
fun <R> CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (CharSequence) -> R ): List<R>
windowedSequence
Возвращает последовательность снимков окна заданного размера size, скользящего по этой последовательности символов с заданным шагом step, где каждый снимок — строка.
fun CharSequence.windowedSequence( size: Int, step: Int = 1, partialWindows: Boolean = false ): Sequence<String>
Возвращает последовательность результатов применения заданной функции трансформации transform к каждой последовательности символов, представляющей представление окна заданного размера size, скользящего по этой последовательности символов с заданным шагом step.
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 и других последовательностей символов с одинаковым индексом. Возвращаемый список имеет длину кратчайшей последовательности символов.
infix fun CharSequence.zip( other: CharSequence ): List<Pair<Char, Char>>
Возвращает список значений, составленных из символов this и других последовательностей символов с одинаковым индексом, используя предоставленную функцию transform, примененную к каждой паре символов. Возвращаемый список имеет длину кратчайшей последовательности символов.
fun <V> CharSequence.zip( other: CharSequence, transform: (a: Char, b: Char) -> V ): List<V>
zipWithNext
Возвращает список пар из двух смежных символов в этой последовательности символов.
fun CharSequence.zipWithNext(): List<Pair<Char, Char>>
Возвращает список, содержащий результаты применения заданной функции transform к каждой паре из двух смежных символов в этой последовательности символов.
fun <R> CharSequence.zipWithNext( transform: (a: Char, b: Char) -> R ): List<R>
Наследники
String
Класс String представляет строки символов. Все строковые литералы в коде Kotlin, такие как "abc", реализованы как экземпляры этого класса.
class String : Comparable<String>, CharSequence
StringBuilder
Изменяемая последовательность символов.
class StringBuilder : Appendable, CharSequence
typealias StringBuilder = StringBuilder
class StringBuilder : CharSequence, Appendable
© 2010–2020 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/-char-sequence/index.html