sdk

sdk/com.m8test.script.core.api.wrapper/PrimitiveArrayWrapper

PrimitiveArrayWrapper

interface PrimitiveArrayWrapper<PT, AT> : ObjectWrapper<AT>

基本数据类型数组包装器.

Author

M8Test, [email protected], https://m8test.com

Inheritors

BooleanArrayWrapper

ByteArrayWrapper

CharArrayWrapper

DoubleArrayWrapper

FloatArrayWrapper

IntArrayWrapper

LongArrayWrapper

ShortArrayWrapper

Functions

abstract fun all(predicate: (PT) -> Boolean): Boolean

如果此数组的所有元素都满足给定的谓词，则返回 true.

abstract fun also(block: (AT) -> Unit): ObjectWrapper<AT>

对 ObjectWrapper 调用给定的 block 函数，并返回 ObjectWrapper 本身。

abstract fun any(predicate: (PT) -> Boolean): Boolean

如果此数组的任何元素都满足给定的谓词，则返回 true.

abstract fun apply(block: AT.() -> Unit): ObjectWrapper<AT>

对 ObjectWrapper 调用给定的 block 函数，并返回 ObjectWrapper 本身。

abstract fun <K, V> associate(transform: (PT) -> Pair<K, V>): MapWrapper<K, V>

将此数组的每个元素与其对应的键值对关联起来，并返回一个新的 MapWrapper.

abstract fun <K, V> associateBy(keySelector: (PT) -> K, valueTransform: (PT) -> V): MapWrapper<K, V>

将此数组的每个元素与其对应的键关联起来，并返回一个新的 MapWrapper.

abstract fun <K, V, M : MutableMapWrapper<in K, in V>> associateByTo(destination: M, keySelector: (PT) -> K, valueTransform: (PT) -> V): M

将此数组的每个元素与其对应的键关联起来，并将结果添加到给定的 MutableMapWrapper 中.

abstract fun <K, V, M : MutableMapWrapper<in K, in V>> associateTo(destination: M, transform: (PT) -> Pair<K, V>): M

将此数组的每个元素与其对应的键值对关联起来，并将结果添加到给定的 MutableMapWrapper 中.

abstract fun <V> associateWith(valueSelector: (PT) -> V): MapWrapper<PT, V>

将此数组的每个元素与其对应的值关联起来，并返回一个新的 MapWrapper.

associateWithTo

abstract fun <V, M : MutableMapWrapper<in PT, in V>> associateWithTo(destination: M, valueSelector: (PT) -> V): M

将此数组的每个元素与其对应的值关联起来，并将结果添加到给定的 MutableMapWrapper 中.

contentToString

abstract fun contentToString(): String

返回此数组内容的字符串表示形式。

abstract fun copyInto(destination: PrimitiveArrayWrapper<PT, AT>, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int): PrimitiveArrayWrapper<PT, AT>

将此数组的元素复制到给定的 PrimitiveArrayWrapper 中.

abstract fun copyOf(newSize: Int): PrimitiveArrayWrapper<PT, AT>

创建一个具有指定大小的新数组，并用此数组的元素填充它.

abstract fun copyOfRange(fromIndex: Int, toIndex: Int): PrimitiveArrayWrapper<PT, AT>

创建一个新数组，并用此数组指定范围内的元素填充它.

abstract fun count(): Int

获取数组元素数量.

abstract fun count(predicate: (PT) -> Boolean): Int

返回此数组中满足给定谓词的元素数量.

abstract fun distinct(): ListWrapper<PT>

获取数组中不重复的元素列表.

abstract fun <K> distinctBy(selector: (PT) -> K): ListWrapper<PT>

根据给定的选择器函数获取数组中不重复的元素列表.

abstract fun drop(n: Int): ListWrapper<PT>

返回删除前 n 个元素的新列表.

abstract fun dropLast(n: Int): ListWrapper<PT>

返回删除最后 n 个元素的新列表.

abstract fun dropLastWhile(predicate: (PT) -> Boolean): ListWrapper<PT>

返回删除满足给定谓词的最后几个元素的新列表.

abstract fun dropWhile(predicate: (PT) -> Boolean): ListWrapper<PT>

返回删除满足给定谓词的开头几个元素的新列表.

abstract fun elementAt(index: Int): PT

获取指定索引处的元素.

elementAtOrElse

abstract fun elementAtOrElse(index: Int, defaultValue: (Int) -> PT): PT

获取指定索引处的元素，如果索引超出范围，则返回默认值.

elementAtOrNull

abstract fun elementAtOrNull(index: Int): PT?

获取指定索引处的元素，如果索引超出范围，则返回 null.

abstract fun fill(element: PT, fromIndex: Int = 0, toIndex: Int)

用给定的元素填充此数组的指定范围.

abstract fun filter(predicate: (PT) -> Boolean): ListWrapper<PT>

返回由满足给定谓词的元素组成的新列表.

abstract fun filterIndexed(predicate: (index: Int, PT) -> Boolean): ListWrapper<PT>

返回由满足给定谓词的元素组成的新列表，并提供元素索引.

filterIndexedTo

abstract fun <C : MutableCollectionWrapper<in PT>> filterIndexedTo(destination: C, predicate: (index: Int, PT) -> Boolean): C

将满足给定谓词的元素添加到目标集合中，并提供元素索引.

abstract fun filterNot(predicate: (PT) -> Boolean): ListWrapper<PT>

返回由不满足给定谓词的元素组成的新列表.

abstract fun <C : MutableCollectionWrapper<in PT>> filterNotTo(destination: C, predicate: (PT) -> Boolean): C

将不满足给定谓词的元素添加到目标集合中.

abstract fun <C : MutableCollectionWrapper<in PT>> filterTo(destination: C, predicate: (PT) -> Boolean): C

将满足给定谓词的元素添加到目标集合中.

abstract fun find(predicate: (PT) -> Boolean): PT?

查找第一个满足给定谓词的元素.

abstract fun findLast(predicate: (PT) -> Boolean): PT?

查找最后一个满足给定谓词的元素.

abstract fun first(predicate: (PT) -> Boolean): PT

返回第一个满足给定谓词的元素.

abstract fun firstOrNull(predicate: (PT) -> Boolean): PT?

返回第一个满足给定谓词的元素，如果没有找到，则返回 null.

abstract fun <R> flatMap(transform: (PT) -> Iterable<R>): ListWrapper<R>

将每个元素转换为一个 Iterable，并将结果合并为一个新列表.

abstract fun <R> flatMapIndexed(transform: (index: Int, PT) -> Iterable<R>): ListWrapper<R>

将每个元素转换为一个 Iterable，并将结果合并为一个新列表，并提供元素索引.

flatMapIndexedTo

abstract fun <R, C : MutableCollectionWrapper<in R>> flatMapIndexedTo(destination: C, transform: (index: Int, PT) -> Iterable<R>): C

将每个元素转换为一个 Iterable，并将结果添加到目标集合中，并提供元素索引.

abstract fun <R, C : MutableCollectionWrapper<in R>> flatMapTo(destination: C, transform: (PT) -> Iterable<R>): C

将每个元素转换为一个 Iterable，并将结果添加到目标集合中.

abstract fun <R> fold(initial: R, operation: (acc: R, PT) -> R): R

通过对每个元素应用操作来累积值.

abstract fun <R> foldIndexed(initial: R, operation: (index: Int, acc: R, PT) -> R): R

通过对每个元素应用操作来累积值，并提供元素索引.

abstract fun <R> foldRight(initial: R, operation: (PT, acc: R) -> R): R

通过从最后一个元素到第一个元素应用操作来累积值.

foldRightIndexed

abstract fun <R> foldRightIndexed(initial: R, operation: (index: Int, PT, acc: R) -> R): R

通过从最后一个元素到第一个元素应用操作来累积值，并提供元素索引.

abstract fun forEach(action: (PT) -> Unit)

对数组的每个元素执行给定的操作.

abstract fun forEachIndexed(action: (index: Int, PT) -> Unit)

对数组的每个元素执行给定的操作，并提供元素索引.

abstract fun getOrElse(index: Int, defaultValue: (Int) -> PT): PT

获取指定索引处的元素，如果索引超出范围，则返回默认值.

abstract override fun getOrigin(): AT

获取被包装的对象.

abstract fun getOrNull(index: Int): PT?

获取指定索引处的元素，如果索引超出范围，则返回 null.

abstract fun <K, V> groupBy(keySelector: (PT) -> K, valueTransform: (PT) -> V): MapWrapper<K, List<V>>

根据给定的键选择器函数将数组元素分组到一个 Map 中.

abstract fun <K, V, M : MutableMapWrapper<in K, MutableList<V>>> groupByTo(destination: M, keySelector: (PT) -> K, valueTransform: (PT) -> V): M

根据给定的键选择器函数将数组元素分组到一个目标 Map 中.

abstract fun indexOfFirst(predicate: (PT) -> Boolean): Int

查找第一个满足给定谓词的元素的索引.

abstract fun indexOfLast(predicate: (PT) -> Boolean): Int

查找最后一个满足给定谓词的元素的索引.

abstract fun intersect(other: Iterable<PT>): SetWrapper<PT>

返回此数组和给定 Iterable 的交集.

abstract fun isEmpty(): Boolean

检查数组是否为空.

abstract fun isNotEmpty(): Boolean

检查数组是否不为空.

abstract fun <A : Appendable> joinTo(buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (PT) -> CharSequence? = null): A

将数组元素连接到给定的 Appendable 对象中.

abstract fun joinToString(separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (PT) -> CharSequence? = null): String

将数组元素连接成一个字符串.

abstract fun last(predicate: (PT) -> Boolean): PT

返回最后一个满足给定谓词的元素.

abstract fun lastOrNull(predicate: (PT) -> Boolean): PT?

返回最后一个满足给定谓词的元素，如果没有找到，则返回 null.

abstract fun <R> let(block: (AT) -> R): ObjectWrapper<R>?

对 ObjectWrapper 调用给定的 block 函数，并返回 block 函数的结果包装在 ObjectWrapper 中。

abstract fun <R> map(transform: (PT) -> R): ListWrapper<R>

将每个元素转换为一个新元素，并返回一个包含所有转换结果的新列表.

abstract fun <R> mapIndexed(transform: (index: Int, PT) -> R): ListWrapper<R>

将每个元素转换为一个新元素，并提供元素索引，并返回一个包含所有转换结果的新列表.

abstract fun <R, C : MutableCollectionWrapper<in R>> mapIndexedTo(destination: C, transform: (index: Int, PT) -> R): C

将每个元素转换为一个新元素，并提供元素索引，并将结果添加到目标集合中.

abstract fun <R, C : MutableCollectionWrapper<in R>> mapTo(destination: C, transform: (PT) -> R): C

将每个元素转换为一个新元素，并将结果添加到目标集合中.

abstract fun <R : Comparable<R>> maxByOrNull(selector: (PT) -> R): PT?

返回根据给定选择器函数选择的最大元素，如果没有找到，则返回 null.

abstract fun <R : Comparable<R>> maxOf(selector: (PT) -> R): R

返回根据给定选择器函数选择的最大值.

abstract fun <R : Comparable<R>> maxOfOrNull(selector: (PT) -> R): R?

返回根据给定选择器函数选择的最大值，如果没有找到，则返回 null.

abstract fun <R : Comparable<R>> minByOrNull(selector: (PT) -> R): PT?

返回根据给定选择器函数选择的最小元素，如果没有找到，则返回 null.

abstract fun <R : Comparable<R>> minOf(selector: (PT) -> R): R

返回根据给定选择器函数选择的最小值.

abstract fun <R : Comparable<R>> minOfOrNull(selector: (PT) -> R): R?

返回根据给定选择器函数选择的最小值，如果没有找到，则返回 null.

abstract fun none(predicate: (PT) -> Boolean): Boolean

如果数组中没有元素满足给定谓词，则返回 true.

abstract fun onEach(action: (PT) -> Unit): PrimitiveArrayWrapper<PT, AT>

对数组的每个元素执行给定的操作，并返回数组本身.

abstract fun onEachIndexed(action: (index: Int, PT) -> Unit): PrimitiveArrayWrapper<PT, AT>

对数组的每个元素执行给定的操作，并提供元素索引，并返回数组本身.

abstract fun partition(predicate: (PT) -> Boolean): Pair<List<PT>, List<PT>>

将数组拆分为两个列表，一个包含满足给定谓词的元素，另一个包含不满足的元素.

abstract fun plus(elements: Collection<PT>): PrimitiveArrayWrapper<PT, AT>

返回一个包含此数组元素和给定集合元素的新数组.

abstract fun random(random: Random): PT

返回数组中的一个随机元素.

abstract fun randomOrNull(random: Random): PT?

返回数组中的一个随机元素，如果没有找到，则返回 null.

abstract fun reduce(operation: (PT, PT) -> PT): PT

通过对数组元素应用操作来累积值.

abstract fun reduceIndexed(operation: (index: Int, acc: PT, PT) -> PT): PT

通过对数组元素应用操作来累积值，并提供元素索引.

reduceIndexedOrNull

abstract fun reduceIndexedOrNull(operation: (index: Int, acc: PT, PT) -> PT): PT?

通过对数组元素应用操作来累积值，并提供元素索引，如果没有找到，则返回 null.

abstract fun reduceOrNull(operation: (acc: PT, PT) -> PT): PT?

通过对数组元素应用操作来累积值，如果没有找到，则返回 null.

abstract fun reduceRight(operation: (PT, acc: PT) -> PT): PT

通过从最后一个元素到第一个元素应用操作来累积值.

reduceRightIndexed

abstract fun reduceRightIndexed(operation: (index: Int, PT, acc: PT) -> PT): PT

通过从最后一个元素到第一个元素应用操作来累积值，并提供元素索引.

reduceRightIndexedOrNull

abstract fun reduceRightIndexedOrNull(operation: (index: Int, PT, acc: PT) -> PT): PT?

通过从最后一个元素到第一个元素应用操作来累积值，并提供元素索引，如果没有找到，则返回 null.

reduceRightOrNull

abstract fun reduceRightOrNull(operation: (PT, acc: PT) -> PT): PT?

通过从最后一个元素到第一个元素应用操作来累积值，如果没有找到，则返回 null.

abstract fun reverse(fromIndex: Int, toIndex: Int)

反转此数组指定范围内的元素顺序.

abstract fun reversed(): ListWrapper<PT>

返回一个包含数组元素反转顺序的新列表.

abstract fun reversedArray(): PrimitiveArrayWrapper<PT, AT>

返回一个包含此数组元素反转顺序的新数组.

abstract fun <R> run(block: AT.() -> R): ObjectWrapper<R>?

对 ObjectWrapper 调用给定的 block 函数，并返回 block 函数的结果包装在 ObjectWrapper 中。

abstract fun <R> runningFold(initial: R, operation: (acc: R, PT) -> R): ListWrapper<R>

返回一个列表，其中包含对数组元素应用操作的累积结果.

runningFoldIndexed

abstract fun <R> runningFoldIndexed(initial: R, operation: (index: Int, acc: R, PT) -> R): ListWrapper<R>

返回一个列表，其中包含对数组元素应用操作的累积结果，并提供元素索引.

abstract fun runningReduce(operation: (acc: PT, PT) -> PT): ListWrapper<PT>

返回一个列表，其中包含对数组元素应用操作的累积结果.

runningReduceIndexed

abstract fun runningReduceIndexed(operation: (index: Int, acc: PT, PT) -> PT): ListWrapper<PT>

返回一个列表，其中包含对数组元素应用操作的累积结果，并提供元素索引.

abstract fun <R> scan(initial: R, operation: (acc: R, PT) -> R): ListWrapper<R>

返回一个列表，其中包含对数组元素应用操作的累积结果.

abstract fun <R> scanIndexed(initial: R, operation: (index: Int, acc: R, PT) -> R): ListWrapper<R>

返回一个列表，其中包含对数组元素应用操作的累积结果，并提供元素索引.

abstract fun set(index: Int, value: PT)

设置指定索引处的元素值.

abstract fun shuffle(random: Random)

使用给定的随机数生成器随机排列此数组的元素.

abstract fun single(predicate: (PT) -> Boolean): PT

返回满足给定谓词的唯一元素.

abstract fun singleOrNull(predicate: (PT) -> Boolean): PT?

返回满足给定谓词的唯一元素，如果没有找到或找到多个，则返回 null.

abstract fun slice(indices: Iterable<Int>): ListWrapper<PT>

返回一个列表，其中包含由给定索引指定的元素.

abstract fun sliceArray(indices: Collection<Int>): PrimitiveArrayWrapper<PT, AT>

返回一个包含此数组指定索引处元素的新数组.

abstract fun <R : Comparable<R>> sortedBy(selector: (PT) -> R?): ListWrapper<PT>

根据给定的选择器函数对元素进行排序，并返回一个包含排序结果的新列表.

sortedByDescending

abstract fun <R : Comparable<R>> sortedByDescending(selector: (PT) -> R?): ListWrapper<PT>

根据给定的选择器函数对元素进行降序排序，并返回一个包含排序结果的新列表.

abstract fun subtract(other: Iterable<PT>): SetWrapper<PT>

返回此数组和给定 Iterable 的差集.

abstract fun take(n: Int): ListWrapper<PT>

返回一个包含数组前 n 个元素的新列表.

abstract fun takeIf(predicate: (AT) -> Boolean): ObjectWrapper<AT>?

如果 ObjectWrapper 满足给定的 predicate，则返回 ObjectWrapper 本身，否则返回 null 包装在 ObjectWrapper? 中。

abstract fun takeLast(n: Int): ListWrapper<PT>

返回一个包含数组最后 n 个元素的新列表.

abstract fun takeLastWhile(predicate: (PT) -> Boolean): ListWrapper<PT>

返回一个包含数组元素的新列表，直到满足给定谓词的最后一个元素.

abstract fun takeUnless(predicate: (AT) -> Boolean): ObjectWrapper<AT>?

如果 ObjectWrapper 不满足给定的 predicate，则返回 ObjectWrapper 本身，否则返回 null 包装在 ObjectWrapper? 中。

abstract fun takeWhile(predicate: (PT) -> Boolean): ListWrapper<PT>

返回一个包含数组元素的新列表，直到满足给定谓词的第一个元素.

abstract fun <C : MutableCollectionWrapper<in PT>> toCollection(destination: C): C

将数组的所有元素添加到给定的集合中.

abstract fun toTypedArray(): ArrayWrapper<PT>

将此包装器转换为 ArrayWrapper.

abstract fun union(other: Iterable<PT>): SetWrapper<PT>

返回此数组和给定 Iterable 的并集.

abstract fun withIndex(): IterableWrapper<IndexedValue<PT>>

返回一个包含数组元素及其索引的 Iterable.

abstract fun <R, V> zip(other: Iterable<R>, transform: (a: PT, b: R) -> V): ListWrapper<V>

将此数组与给定的 Iterable 组合，并返回一个包含组合结果的新列表.