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
Добавляет все символы, соответствующие заданному предикату, к заданному назначению.
fun <C : Appendable> CharSequence.filterIndexedTo( destination: C, predicate: (index: Int, Char) -> Boolean ): C
filterNot
Возвращает последовательность символов, содержащую только те символы из исходной последовательности символов, которые не соответствуют заданному предикату.
fun CharSequence.filterNot( predicate: (Char) -> Boolean ): CharSequence
filterNotTo
Добавляет все символы, не соответствующие заданному предикату, к заданному назначению.
fun <C : Appendable> CharSequence.filterNotTo( destination: C, predicate: (Char) -> Boolean ): C
filterTo
Добавляет все символы, соответствующие заданному предикату, к заданному назначению.
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>?
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, которая вызывается для каждого символа и его индекса в исходной последовательности символов, в заданное место назначения.
fun <R, C : MutableCollection<in R>> CharSequence.flatMapIndexedTo( destination: C, transform: (index: Int, Char) -> Iterable<R> ): C
flatMapTo
Добавляет все элементы, полученные из результатов функции transform, которая вызывается для каждого символа исходной последовательности символов, в заданное место назначения.
fun <R, C : MutableCollection<in R>> CharSequence.flatMapTo( destination: C, transform: (Char) -> Iterable<R> ): C
fold
foldIndexed
foldRight
foldRightIndexed
forEachIndexed
Выполняет заданное действие для каждого символа, предоставляя последовательный индекс с символом.
fun CharSequence.forEachIndexed( action: (index: Int, Char) -> Unit)
getOrElse
Возвращает символ по заданному , если
fun CharSequence.getOrElse(
index: Int,
defaultValue: (Int) -> Char
): Char
getOrNull
Возвращает символ по заданному находится вне границ этой последовательности символов.
fun CharSequence.getOrNull(index: Int): Char?
groupBy
Группирует символы исходной последовательности символов по ключу, возвращаемому заданной функцией
fun <K> CharSequence.groupBy(
keySelector: (Char) -> K
): Map<K, List<Char>>
Группирует значения, возвращаемые функцией , примененной к символу, и возвращает карту, где каждый ключ группы сопоставлен со списком соответствующих значений.
fun <K, V> CharSequence.groupBy( keySelector: (Char) -> K, valueTransform: (Char) -> V ): Map<K, List<V>>
groupByTo
Группирует символы исходной последовательности символов по ключу, возвращаемому заданной функцией каждый ключ группы, связанный со списком соответствующих символов.
fun <K, M : MutableMap<in K, MutableList<Char>>> CharSequence.groupByTo( destination: M, keySelector: (Char) -> K ): M
groupingBy
Создаёт источник Grouping из последовательности символов для последующего использования с операциями группирования и сворачивания, используя указанную функцию
fun <K> CharSequence.groupingBy(
keySelector: (Char) -> K
): Grouping<Char, K>
hasSurrogatePairAt
Возвращает true , если в этой последовательности символов по указанному
fun CharSequence.hasSurrogatePairAt(index: Int): Boolean
indexOf
Возвращает индекс в этой строке первого вхождения указанного символа, начиная с указанного начального индекса.
fun CharSequence.indexOf( char: Char, 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
isEmpty
Возвращает true если эта последовательность символов пустая (не содержит символов).
fun CharSequence.isEmpty(): Boolean
isNotBlank
Возвращает true если эта последовательность символов не пустая и содержит некоторые символы, кроме пробельных.
fun CharSequence.isNotBlank(): Boolean
isNotEmpty
Возвращает true если эта последовательность символов не пустая.
fun CharSequence.isNotEmpty(): Boolean
isNullOrBlank
Возвращает true если эта необязательная последовательность символов либо null , либо пустая, либо состоит только из пробельных символов.
fun CharSequence?.isNullOrBlank(): Boolean
isNullOrEmpty
Возвращает true если эта необязательная последовательность символов либо 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
Возвращает наибольшее значение в соответствии с предоставленным comparator среди всех значений, полученных с помощью функции 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
Выполняет заданное action для каждого символа и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEach(action: (Char) -> Unit): S
onEachIndexed
Выполняет заданное action для каждого символа, предоставляя порядковый индекс с символом, и возвращает саму последовательность символов после этого.
fun <S : CharSequence> S.onEachIndexed( action: (index: Int, Char) -> Unit ): S
padEnd
Возвращает последовательность символов с содержимым этой последовательности символов, дополненную в конце до указанной length указанным символом или пробелом.
fun CharSequence.padEnd( length: Int, padChar: Char = ' ' ): CharSequence
padStart
Возвращает последовательность символов с содержимым этой последовательности символов, дополненную в начале до указанной length указанным символом или пробелом.
fun CharSequence.padStart( length: Int, padChar: Char = ' ' ): CharSequence
partition
Разделяет исходную последовательность символов на пару последовательностей символов, где первая последовательность символов содержит символы, для которых predicate возвратил true, а вторая последовательность символов содержит символы, для которых predicate возвратил 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
Накапливает значение, начиная с первого символа и применяя 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?
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
Возвращает новую строку, полученную заменой каждой подстроки этой последовательности символов, которая соответствует заданному регулярному выражению, результатом заданной функции transform, которая принимает MatchResult и возвращает строку, используемую в качестве замены для этого соответствия.
fun CharSequence.replace( regex: Regex, transform: (MatchResult) -> CharSequence ): String
replaceFirst
replaceRange
Возвращает последовательность символов с содержимым этой последовательности символов, где её часть в заданном диапазоне заменена на замену последовательность символов.
fun CharSequence.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): CharSequence
reversed
Возвращает последовательность символов с символами в обратном порядке.
fun CharSequence.reversed(): CharSequence
runningFold
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 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>
Разделяет эту последовательность символов на последовательность строк вокруг совпадений с заданным регулярным выражением.
fun CharSequence.splitToSequence( regex: Regex, 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
Добавляет все символы в заданную коллекцию destination.
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
Возвращает подпоследовательность этой последовательности символов, у которой удалены ведущие и завершающие символы, соответствующие предикату predicate.
fun CharSequence.trim( predicate: (Char) -> Boolean ): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены ведущие и завершающие символы из массива chars.
fun CharSequence.trim(vararg chars: Char): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены ведущие и завершающие пробелы.
fun CharSequence.trim(): CharSequence
trimEnd
Возвращает подпоследовательность этой последовательности символов, у которой удалены завершающие символы, соответствующие предикату predicate.
fun CharSequence.trimEnd( predicate: (Char) -> Boolean ): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены завершающие символы из массива chars.
fun CharSequence.trimEnd(vararg chars: Char): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены завершающие пробелы.
fun CharSequence.trimEnd(): CharSequence
trimStart
Возвращает подпоследовательность этой последовательности символов, у которой удалены ведущие символы, соответствующие предикату predicate.
fun CharSequence.trimStart( predicate: (Char) -> Boolean ): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены ведущие символы из массива chars.
fun CharSequence.trimStart(vararg chars: Char): CharSequence
Возвращает подпоследовательность этой последовательности символов, у которой удалены ведущие пробелы.
fun CharSequence.trimStart(): CharSequence
windowed
Возвращает список снимков окна заданного размера, скользящего вдоль этой последовательности символов с заданным шагом, где каждый снимок — строка.
fun CharSequence.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false ): List<String>
Возвращает список результатов применения заданной функции transform к каждой последовательности символов, представляющей собой вид на окно заданного размера, скользящего вдоль этой последовательности символов с заданным шагом.
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>
Возвращает последовательность результатов применения заданной функции transform к каждой последовательности символов, представляющей собой вид на окно заданного размера, скользящего вдоль этой последовательности символов с заданным шагом.
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–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/-char-sequence/index.html