CharArray
class CharArray
Для Common, JVM, JS
Массив символов. При нацеливании на JVM экземпляры этого класса представляются как char[].
Для Native
Массив символов.
Конструкторы
<init>
Создаёт новый массив указанного размера, где каждый элемент рассчитывается с помощью указанной функции init.
<init>(size: Int, init: (Int) -> Char)
Создаёт новый массив указанного размера, где все элементы инициализированы нулевым символом (`\u0000').
<init>(size: Int)
Свойства
size
Возвращает количество элементов в массиве.
val size: Int
Функции
get
Возвращает элемент массива по заданному индексу. Этот метод можно вызывать с помощью оператора индекса.
operator fun get(index: Int): Char
iterator
Создаёт итератор по элементам массива.
operator fun iterator(): CharIterator
Расширяемые свойства
indices
Возвращает диапазон допустимых индексов для массива.
val CharArray.indices: IntRange
lastIndex
Возвращает последний допустимый индекс для массива.
val CharArray.lastIndex: Int
Расширяемые функции
all
Возвращает true , если все элементы соответствуют заданному предикату.
fun CharArray.all(predicate: (Char) -> Boolean): Boolean
any
Возвращает true , если массив содержит хотя бы один элемент.
fun CharArray.any(): Boolean
Возвращает true , если хотя бы один элемент соответствует заданному предикату.
fun CharArray.any(predicate: (Char) -> Boolean): Boolean
asIterable
Создаёт экземпляр Iterable, который оборачивает исходный массив, возвращая его элементы при итерации.
fun CharArray.asIterable(): Iterable<Char>
asSequence
Создаёт экземпляр Sequence, который оборачивает исходный массив, возвращая его элементы при итерации.
fun CharArray.asSequence(): Sequence<Char>
associate
associateBy
Возвращает Map, содержащий элементы из заданного массива, индексированные ключом, возвращаемым функцией keySelector, применённой к каждому элементу.
fun <K> CharArray.associateBy( keySelector: (Char) -> K ): Map<K, Char>
Возвращает Map, содержащий значения, предоставленные функцией valueTransform и индексированные функцией keySelector, применёнными к элементам заданного массива.
fun <K, V> CharArray.associateBy( keySelector: (Char) -> K, valueTransform: (Char) -> V ): Map<K, V>
associateByTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, применённой к каждому элементу заданного массива, а значением является сам элемент.
fun <K, M : MutableMap<in K, in Char>> CharArray.associateByTo( destination: M, keySelector: (Char) -> K ): M
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, а значение предоставляется функцией valueTransform, применёнными к элементам заданного массива.
fun <K, V, M : MutableMap<in K, in V>> CharArray.associateByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M
associateTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, полученными с помощью функции transform, применённой к каждому элементу заданного массива.
fun <K, V, M : MutableMap<in K, in V>> CharArray.associateTo( destination: M, transform: (Char) -> Pair<K, V> ): M
associateWith
Возвращает Map, где ключи — элементы из заданного массива, а значения — результаты применения функции valueSelector к каждому элементу.
fun <V> CharArray.associateWith( valueSelector: (Char) -> V ): Map<Char, V>
associateWithTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение для каждого элемента заданного массива, где ключ — сам элемент, а значение — результат применения функции valueSelector к этому ключу.
fun <V, M : MutableMap<in Char, in V>> CharArray.associateWithTo( destination: M, valueSelector: (Char) -> V ): M
binarySearch
Ищет в массиве или в диапазоне массива заданный элемент с помощью алгоритма бинарного поиска. Массив должен быть отсортирован, в противном случае результат не определен.
fun CharArray.binarySearch( element: Char, fromIndex: Int = 0, toIndex: Int = size ): Int
component1
Возвращает 1-й элемент из массива.
operator fun CharArray.component1(): Char
component2
Возвращает 2-й элемент из массива.
operator fun CharArray.component2(): Char
component3
Возвращает 3-й элемент из массива.
operator fun CharArray.component3(): Char
component4
Возвращает 4-й элемент из массива.
operator fun CharArray.component4(): Char
component5
Возвращает 5-й элемент из массива.
operator fun CharArray.component5(): Char
filter
Возвращает список, содержащий только элементы, соответствующие заданному предикату.
fun CharArray.filter( predicate: (Char) -> Boolean ): List<Char>
filterIndexed
Возвращает список, содержащий только элементы, соответствующие заданному предикату.
fun CharArray.filterIndexed( predicate: (index: Int, Char) -> Boolean ): List<Char>
filterIndexedTo
Добавляет все элементы, соответствующие заданному предикату, в заданное назначение.
fun <C : MutableCollection<in Char>> CharArray.filterIndexedTo( destination: C, predicate: (index: Int, Char) -> Boolean ): C
filterNot
Возвращает список, содержащий все элементы, не соответствующие заданному предикату.
fun CharArray.filterNot( predicate: (Char) -> Boolean ): List<Char>
filterNotTo
Добавляет все элементы, не соответствующие заданному предикату, в заданное назначение.
fun <C : MutableCollection<in Char>> CharArray.filterNotTo( destination: C, predicate: (Char) -> Boolean ): C
filterTo
Добавляет все элементы, соответствующие заданному предикату, в заданное назначение.
fun <C : MutableCollection<in Char>> CharArray.filterTo( destination: C, predicate: (Char) -> Boolean ): C
flatMapTo
Добавляет все элементы, полученные в результате вызова функции transform для каждого элемента исходного массива, в заданное назначение.
fun <R, C : MutableCollection<in R>> CharArray.flatMapTo( destination: C, transform: (Char) -> Iterable<R> ): C
fold
foldIndexed
foldRight
foldRightIndexed
forEach
Выполняет заданное действие для каждого элемента.
fun CharArray.forEach(action: (Char) -> Unit)
forEachIndexed
Выполняет заданное действие для каждого элемента, предоставляя последовательный индекс с элементом.
fun CharArray.forEachIndexed( action: (index: Int, Char) -> Unit)
getOrElse
Возвращает элемент по заданному индексу или результат вызова функции defaultValue, если индекс выходит за пределы этого массива.
fun CharArray.getOrElse( index: Int, defaultValue: (Int) -> Char ): Char
getOrNull
groupBy
Группирует элементы исходного массива по ключу, возвращаемому заданной функцией keySelector, применённой к каждому элементу, и возвращает карту, где каждый ключ группы связан со списком соответствующих элементов.
fun <K> CharArray.groupBy( keySelector: (Char) -> K ): Map<K, List<Char>>
Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходного массива, по ключу, возвращаемому заданной функцией keySelector, применённой к элементу, и возвращает карту, где каждый ключ группы связан со списком соответствующих значений.
fun <K, V> CharArray.groupBy( keySelector: (Char) -> K, valueTransform: (Char) -> V ): Map<K, List<V>>
groupByTo
Группирует элементы исходного массива по ключу, возвращаемому функцией keySelector, применённой к каждому элементу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих элементов.
fun <K, M : MutableMap<in K, MutableList<Char>>> CharArray.groupByTo( destination: M, keySelector: (Char) -> K ): M
Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходного массива, по ключу, возвращаемому заданной функцией keySelector, применённой к элементу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих значений.
fun <K, V, M : MutableMap<in K, MutableList<V>>> CharArray.groupByTo( destination: M, keySelector: (Char) -> K, valueTransform: (Char) -> V ): M
indexOf
Возвращает первый индекс элемента element, или -1, если массив не содержит элемент.
fun CharArray.indexOf(element: Char): Int
indexOfFirst
Возвращает индекс первого элемента, удовлетворяющего заданному предикату, или -1, если массив не содержит такой элемент.
fun CharArray.indexOfFirst(predicate: (Char) -> Boolean): Int
indexOfLast
Возвращает индекс последнего элемента, удовлетворяющего заданному предикату, или -1, если массив не содержит такой элемент.
fun CharArray.indexOfLast(predicate: (Char) -> Boolean): Int
intersect
Возвращает множество, содержащее все элементы, которые содержатся как в этом массиве, так и в заданном наборе.
infix fun CharArray.intersect( other: Iterable<Char> ): Set<Char>
isEmpty
Возвращает true , если массив пуст.
fun CharArray.isEmpty(): Boolean
isNotEmpty
Возвращает true , если массив не пуст.
fun CharArray.isNotEmpty(): Boolean
joinTo
Добавляет строку из всех элементов, разделенных с помощью separator и с использованием заданных prefix и postfix, если они предоставлены.
fun <A : Appendable> CharArray.joinTo( buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: ((Char) -> CharSequence)? = null ): A
joinToString
Создаёт строку из всех элементов, разделённых с помощью separator и с использованием заданных prefix и postfix, если они предоставлены.
fun CharArray.joinToString( separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: ((Char) -> CharSequence)? = null ): String
last
Возвращает последний элемент.
fun CharArray.last(): Char
Возвращает последний элемент, удовлетворяющий заданному предикату.
fun CharArray.last(predicate: (Char) -> Boolean): Char
lastIndexOf
Возвращает последний индекс элемента element, или -1, если массив не содержит элемент.
fun CharArray.lastIndexOf(element: Char): Int
lastOrNull
Возвращает последний элемент или null если массив пустой.
fun CharArray.lastOrNull(): Char?
Возвращает последний элемент, соответствующий заданному предикату, или null если такой элемент не найден.
fun CharArray.lastOrNull(predicate: (Char) -> Boolean): Char?
map
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу в исходном массиве.
fun <R> CharArray.map(transform: (Char) -> R): List<R>
mapIndexed
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу и его индексу в исходном массиве.
fun <R> CharArray.mapIndexed( transform: (index: Int, Char) -> R ): List<R>
mapIndexedTo
Применяет заданную функцию преобразования к каждому элементу и его индексу в исходном массиве и добавляет результаты в заданное назначение.
fun <R, C : MutableCollection<in R>> CharArray.mapIndexedTo( destination: C, transform: (index: Int, Char) -> R ): C
mapTo
Применяет заданную функцию преобразования к каждому элементу исходного массива и добавляет результаты в заданное назначение.
fun <R, C : MutableCollection<in R>> CharArray.mapTo( destination: C, transform: (Char) -> R ): C
minByOrNull
Возвращает первый элемент, дающий наименьшее значение заданной функции, или null если элементов нет.
fun <R : Comparable<R>> CharArray.minByOrNull( selector: (Char) -> R ): Char?
minOf
Возвращает наименьшее значение среди всех значений, полученных функцией selector, примененной к каждому элементу в массиве.
fun <R : Comparable<R>> any_array<R>.minOf( selector: (Char) -> R ): R
minOfOrNull
Возвращает наименьшее значение среди всех значений, полученных функцией selector, примененной к каждому элементу в массиве, или null если элементов нет.
fun <R : Comparable<R>> any_array<R>.minOfOrNull( selector: (Char) -> R ): R?
minOfWith
Возвращает наименьшее значение по предоставленному сравнителю среди всех значений, полученных функцией selector, примененной к каждому элементу в массиве.
fun <R> CharArray.minOfWith( comparator: Comparator<in R>, selector: (Char) -> R ): R
minOfWithOrNull
Возвращает наименьшее значение по предоставленному сравнителю среди всех значений, полученных функцией selector, примененной к каждому элементу в массиве, или null если элементов нет.
fun <R> CharArray.minOfWithOrNull( comparator: Comparator<in R>, selector: (Char) -> R ): R?
minOrNull
Возвращает наименьший элемент или null если элементов нет.
fun CharArray.minOrNull(): Char?
minWith
Возвращает первый элемент с наименьшим значением в соответствии с предоставленным сравнителем.
fun CharArray.minWith(comparator: Comparator<in Char>): Char
fun CharArray.minWith(comparator: Comparator<in Char>): Char?
minWithOrNull
Возвращает первый элемент с наименьшим значением в соответствии с предоставленным сравнителем или null если элементов нет.
fun CharArray.minWithOrNull( comparator: Comparator<in Char> ): Char?
none
Возвращает true если в массиве нет элементов.
fun CharArray.none(): Boolean
Возвращает true если ни один элемент не соответствует заданному предикату.
fun CharArray.none(predicate: (Char) -> Boolean): Boolean
onEach
Выполняет заданное действие над каждым элементом и возвращает сам массив после этого.
fun CharArray.onEach(action: (Char) -> Unit): CharArray
onEachIndexed
Выполняет заданное действие над каждым элементом, предоставляя последовательный индекс с элементом, и возвращает сам массив после этого.
fun CharArray.onEachIndexed( action: (index: Int, Char) -> Unit ): CharArray
partition
random
Возвращает случайный элемент из этого массива.
fun CharArray.random(): Char
Возвращает случайный элемент из этого массива, используя указанный источник случайности.
fun CharArray.random(random: Random): Char
randomOrNull
Возвращает случайный элемент из этого массива или null если этот массив пуст.
fun CharArray.randomOrNull(): Char?
Возвращает случайный элемент из этого массива, используя указанный источник случайности, или null если этот массив пуст.
fun CharArray.randomOrNull(random: Random): Char?
reduce
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу.
fun CharArray.reduce( operation: (acc: Char, Char) -> Char ): Char
reduceIndexed
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходном массиве.
fun CharArray.reduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): Char
reduceIndexedOrNull
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходном массиве.
fun CharArray.reduceIndexedOrNull( operation: (index: Int, acc: Char, Char) -> Char ): Char?
reduceOrNull
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу.
fun CharArray.reduceOrNull( operation: (acc: Char, Char) -> Char ): Char?
reduceRight
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу и текущему значению аккумулятора.
fun CharArray.reduceRight( operation: (Char, acc: Char) -> Char ): Char
reduceRightIndexed
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу с его индексом в исходном массиве и текущему значению аккумулятора.
fun CharArray.reduceRightIndexed( operation: (index: Int, Char, acc: Char) -> Char ): Char
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу с его индексом в исходном массиве и текущему значению аккумулятора.
fun CharArray.reduceRightIndexedOrNull( operation: (index: Int, Char, acc: Char) -> Char ): Char?
reduceRightOrNull
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу и текущему значению аккумулятора.
fun CharArray.reduceRightOrNull( operation: (Char, acc: Char) -> Char ): Char?
refTo
fun CharArray.refTo(index: Int): CValuesRef<COpaque>
reverse
Инвертирует элементы в массиве на месте.
fun CharArray.reverse()
Инвертирует элементы массива в указанном диапазоне на месте.
fun CharArray.reverse(fromIndex: Int, toIndex: Int)
reversed
Возвращает список с элементами в обратном порядке.
fun CharArray.reversed(): List<Char>
reversedArray
Возвращает массив с элементами этого массива в обратном порядке.
fun CharArray.reversedArray(): CharArray
runningFold
runningFoldIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу, его индексу в исходном массиве и текущему значению накопителя, которое начинается со значения initial.
fun <R> CharArray.runningFoldIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): List<R>
runningReduce
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу и текущему значению накопителя, которое начинается с первого элемента этого массива.
fun CharArray.runningReduce( operation: (acc: Char, Char) -> Char ): List<Char>
runningReduceIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу, его индексу в исходном массиве и текущему значению накопителя, которое начинается с первого элемента этого массива.
fun CharArray.runningReduceIndexed( operation: (index: Int, acc: Char, Char) -> Char ): List<Char>
scan
scanIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу, его индексу в исходном массиве и текущему значению накопителя, которое начинается со значения initial.
fun <R> CharArray.scanIndexed( initial: R, operation: (index: Int, acc: R, Char) -> R ): List<R>
shuffle
Случайным образом перемешивает элементы в этом массиве на месте.
fun CharArray.shuffle()
Случайным образом перемешивает элементы в этом массиве на месте, используя указанный источник случайности.
fun CharArray.shuffle(random: Random)
single
Возвращает единственный элемент или выбрасывает исключение, если массив пуст или содержит более одного элемента.
fun CharArray.single(): Char
Возвращает единственный элемент, соответствующий заданному предикату, или выбрасывает исключение, если такого элемента нет или их больше одного.
fun CharArray.single(predicate: (Char) -> Boolean): Char
singleOrNull
Возвращает единственный элемент, или null если массив пуст или содержит более одного элемента.
fun CharArray.singleOrNull(): Char?
Возвращает единственный элемент, соответствующий заданному предикату, или null если элемент не найден или найдено более одного элемента.
fun CharArray.singleOrNull( predicate: (Char) -> Boolean ): Char?
slice
Возвращает список, содержащий элементы в указанном диапазоне индексов.
fun CharArray.slice(indices: IntRange): List<Char>
Возвращает список, содержащий элементы по указанным индексам.
fun CharArray.slice(indices: Iterable<Int>): List<Char>
sliceArray
Возвращает массив, содержащий элементы этого массива по указанным индексам.
fun CharArray.sliceArray(indices: Collection<Int>): CharArray
Возвращает массив, содержащий элементы в указанном диапазоне индексов.
fun CharArray.sliceArray(indices: IntRange): CharArray
sort
Сортирует массив на месте в соответствии с порядком, заданным заданной функцией сравнения.
fun CharArray.sort(comparison: (a: Char, b: Char) -> Int)
sortDescending
Сортирует элементы в массиве по убыванию в соответствии с их естественным порядком сортировки.
fun CharArray.sortDescending()
Сортирует элементы массива в указанном диапазоне по убыванию в соответствии с их естественным порядком сортировки.
fun CharArray.sortDescending(fromIndex: Int, toIndex: Int)
sorted
Возвращает список всех элементов, отсортированных по их естественному порядку сортировки.
fun CharArray.sorted(): List<Char>
sortedArray
Возвращает массив со всеми элементами этого массива, отсортированными по их естественному порядку сортировки.
fun CharArray.sortedArray(): CharArray
sortedArrayDescending
Возвращает массив со всеми элементами этого массива, отсортированными по убыванию в соответствии с их естественным порядком сортировки.
fun CharArray.sortedArrayDescending(): CharArray
sortedBy
Возвращает список всех элементов, отсортированных по естественному порядку сортировки значения, возвращаемого указанной функцией selector.
fun <R : Comparable<R>> CharArray.sortedBy( selector: (Char) -> R? ): List<Char>
sortedByDescending
Возвращает список всех элементов, отсортированных по убыванию в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией selector.
fun <R : Comparable<R>> CharArray.sortedByDescending( selector: (Char) -> R? ): List<Char>
sortedDescending
Возвращает список всех элементов, отсортированных по убыванию в соответствии с их естественным порядком сортировки.
fun CharArray.sortedDescending(): List<Char>
sortedWith
Возвращает список всех элементов, отсортированных по указанному comparator.
fun CharArray.sortedWith( comparator: Comparator<in Char> ): List<Char>
takeWhile
Возвращает список, содержащий первые элементы, удовлетворяющие заданному предикату.
fun CharArray.takeWhile( predicate: (Char) -> Boolean ): List<Char>
toCollection
Добавляет все элементы в заданную коллекцию назначения.
fun <C : MutableCollection<in Char>> CharArray.toCollection( destination: C ): C
toHashSet
Возвращает новый HashSet всех элементов.
fun CharArray.toHashSet(): HashSet<Char>
toList
Возвращает список содержащий все элементы.
fun CharArray.toList(): List<Char>
toMutableList
Возвращает новый MutableList, заполненный всеми элементами этого массива.
fun CharArray.toMutableList(): MutableList<Char>
toMutableSet
Возвращает новый MutableSet, содержащий все уникальные элементы из заданного массива.
fun CharArray.toMutableSet(): MutableSet<Char>
toSet
Возвращает множество всех элементов.
fun CharArray.toSet(): Set<Char>
toSortedSet
Возвращает новый SortedSet всех элементов.
fun CharArray.toSortedSet(): SortedSet<Char>
union
Возвращает множество, содержащее все уникальные элементы из обеих коллекций.
infix fun CharArray.union(other: Iterable<Char>): Set<Char>
withIndex
Возвращает ленивую Iterable, которая оборачивает каждый элемент исходного массива в IndexedValue, содержащий индекс этого элемента и сам элемент.
fun CharArray.withIndex(): Iterable<IndexedValue<Char>>
zip
Возвращает список пар, созданных из элементов массива this и массива другого с тем же индексом. Возвращаемый список имеет длину самой короткой коллекции.
infix fun <R> any_array<R>.zip( other: Array<out R> ): List<Pair<Char, R>>
Возвращает список значений, созданных из элементов массива this и массива другого с тем же индексом, используя предоставленную функцию преобразования для каждой пары элементов. Возвращаемый список имеет длину самой короткой коллекции.
fun <R, V> CharArray.zip( other: Array<out R>, transform: (a: Char, b: R) -> V ): List<V>
Возвращает список пар, созданных из элементов коллекции this и массива другого с тем же индексом. Возвращаемый список имеет длину самой короткой коллекции.
infix fun <R> CharArray.zip( other: Iterable<R> ): List<Pair<Char, R>>
Возвращает список значений, созданных из элементов массива this и коллекции другого с тем же индексом, используя предоставленную функцию преобразования для каждой пары элементов. Возвращаемый список имеет длину самой короткой коллекции.
fun <R, V> CharArray.zip( other: Iterable<R>, transform: (a: Char, b: R) -> V ): List<V>
Возвращает список значений, созданных из элементов массива this и массива другого с тем же индексом, используя предоставленную функцию преобразования для каждой пары элементов. Возвращаемый список имеет длину самого короткого массива.
fun <V> CharArray.zip( other: CharArray, transform: (a: Char, b: Char) -> V ): List<V>
© 2010–2023 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-array/index.html