Array<T>

类型为 T 的有序、可索引的元素集合。

种类: object

静态方法

from

Array.from(values: T): Array<T>

Creates a new array containing the provided values.

参数

名称	类型	默认值	说明
values	T		Variable number of elements to include in the array.

返回: Array<T>

---

new

Array.new(size: int = 0, initial_value: T = na): const Array<T>

Creates a new empty array of type T.

参数

名称	类型	默认值	说明
size	int	0	The initial size of the array.
initial_value	T	na	The initial value for all elements.

返回: const Array<T>

---

new_bool

Array.new_bool(size: int = 0, initial_value: bool = na): Array<bool>

Creates a new array of bool values.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	bool	na	Initial value for all elements. Default is na.

返回: Array<bool>

---

new_box

Array.new_box(size: int = 0, initial_value: Box = na): Array<Box>

Creates a new array of Box ids.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	Box	na	Initial value for all elements. Default is na.

返回: Array<Box>

---

new_color

Array.new_color(size: int = 0, initial_value: color = na): Array<color>

Creates a new array of color values.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	color	na	Initial value for all elements. Default is na.

返回: Array<color>

---

new_float

Array.new_float(size: int = 0, initial_value: float = na): Array<float>

Creates a new array of float values.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	float	na	Initial value for all elements. Default is na.

返回: Array<float>

---

new_int

Array.new_int(size: int = 0, initial_value: int = na): Array<int>

Creates a new array of int values.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	int	na	Initial value for all elements. Default is na.

返回: Array<int>

---

new_label

Array.new_label(size: int = 0, initial_value: Label = na): Array<Label>

Creates a new array of Label ids.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	Label	na	Initial value for all elements. Default is na.

返回: Array<Label>

---

new_line

Array.new_line(size: int = 0, initial_value: Line = na): Array<Line>

Creates a new array of Line ids.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	Line	na	Initial value for all elements. Default is na.

返回: Array<Line>

---

new_linefill

Array.new_linefill(size: int = 0, initial_value: Linefill = na): Array<Linefill>

Creates a new array of Linefill ids.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	Linefill	na	Initial value for all elements. Default is na.

返回: Array<Linefill>

---

new_string

Array.new_string(size: int = 0, initial_value: string = na): Array<string>

Creates a new array of string values.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	string	na	Initial value for all elements. Default is na.

返回: Array<string>

---

new_table

Array.new_table(size: int = 0, initial_value: Table = na): Array<Table>

Creates a new array of Table ids.

参数

名称	类型	默认值	说明
size	int	0	Initial size of the array. Default is 0.
initial_value	Table	na	Initial value for all elements. Default is na.

返回: Array<Table>

方法

abs

返回一个新数组，其中包含输入 array 的元素的绝对值。

参数

名称	类型	默认值	说明
id	Array<int>		整数元素的传入数组。

返回: Array<int>

返回一个新数组，其中包含输入 array 的元素的绝对值。

参数

名称	类型	默认值	说明
id	Array<float>		浮点元素的传入数组。

返回: Array<float>

---

avg

返回输入 array 中元素的平均值。

参数

名称	类型	默认值	说明
id	series Array<int>		整数元素的传入数组。

返回: float

返回平均值。

参数

名称	类型	默认值	说明
id	series Array<float>		浮点元素的传入数组。

返回: float

---

binary_search

对给定排序的 array 中指定的 value 执行二分搜索，如果找到则返回该值的索引，如果未找到则返回 -1。

参数

名称	类型	默认值	说明
id	Array<int>		要搜索的已排序整数数组。
value	int		要搜索的值。

返回: int — 值的索引，如果未找到则为 -1。数组必须按升序排序。

在已排序的 array 中对指定的 value 执行二分搜索，如果找到则返回该值的索引，否则返回 -1。

参数

名称	类型	默认值	说明
id	Array<float>		要搜索的已排序浮点数组。
value	float		要搜索的值。

返回: int — 该值的索引；如果未找到则返回 -1。数组必须按升序排序。

---

binary_search_leftmost

返回已排序 array 中匹配值的索引。

如果未找到该值，则返回该值插入位置左侧最近较小元素的索引。要搜索的数组必须按升序排序。

参数

名称	类型	默认值	说明
id	Array<int>		要搜索的已排序整数数组。
value	int		要搜索的值。

返回: int

返回已排序 array 中匹配值的索引。

如果未找到该值，则返回该值插入位置左侧最近较小元素的索引。要搜索的数组必须按升序排序。

参数

名称	类型	默认值	说明
id	Array<float>		要搜索的已排序浮点数组。
value	float		要搜索的值。

返回: int

---

binary_search_rightmost

如果找到该值，则返回该值的索引。

当未找到该值时，该函数将返回该值所在位置右侧元素的索引。数组必须按升序排序。

参数

名称	类型	默认值	说明
id	Array<int>		要搜索的已排序整数数组。
value	int		要搜索的值。

返回: int

如果找到该值，则返回该值的索引。

当未找到该值时，该函数将返回该值所在位置右侧元素的索引。数组必须按升序排序。

参数

名称	类型	默认值	说明
id	Array<float>		要搜索的已排序浮点数组。
value	float		要搜索的值。

返回: int

---

clear

Array.clear(id: series Array<T>)

清空给定 array 中的所有元素。

参数

名称	类型	默认值	说明
id	series Array<T>		要清空的数组。

---

concat

Array.concat(id1: Array<T>, id2: Array<T>): Array<T>

拼接相同类型 T 的两个数组 array1 和 array2 并返回一个包含两个数组中所有元素的新数组。

参数

名称	类型	默认值	说明
id1	Array<T>		要连接的第一个数组。
id2	Array<T>		要连接的第二个数组。

返回: Array<T>

---

copy

Array.copy(id: Array<T>): Array<T>

创建给定 array 的拷贝并返回新数组。

参数

名称	类型	默认值	说明
id	Array<T>		要复制的数组。

返回: Array<T>

---

covariance

计算相同类型 T 的两个数组 array1 和 array2 之间的协方差。

参数

名称	类型	默认值	说明
id1	Array<float>		第一个传入数组。
id2	Array<float>		第二个传入数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

计算两个数组 array1 和 array2 的协方差。

参数

名称	类型	默认值	说明
id1	Array<int>		第一个传入数组。
id2	Array<int>		第二个传入数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

计算两个数组 array1 和 array2 的协方差。

参数

名称	类型	默认值	说明
id1	Array<int>		第一个传入数组。
id2	Array<float>		第二个传入数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

计算两个数组 array1 和 array2 的协方差。

参数

名称	类型	默认值	说明
id1	Array<float>		第一个传入数组。
id2	Array<int>		第二个传入数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

---

every

检查给定布尔值 array 中的每个元素是否都是 true。如果所有元素都是 true，则返回 true，否则返回 false。

参数

名称	类型	默认值	说明
id	Array<bool>		要检查的数组。

返回: bool

检查给定 array 中的每个元素是否都求值为 true。

参数

名称	类型	默认值	说明
id	Array<int>		要检查的数组。

返回: bool

检查给定 array 中的每个元素是否都求值为 true。

参数

名称	类型	默认值	说明
id	Array<float>		要检查的数组。

返回: bool

---

fill

Array.fill(id: Array<T>, value: T, index_from: int = 0, index_to: int = na)

使用指定的 value 从 index_from 到 index_to 填充给定 array 的元素。

参数

名称	类型	默认值	说明
id	Array<T>		要填充的数组。
value	T		要填充的值。
index_from	int	0	起始索引（含）。
index_to	int	na	结束索引（不包括）。当 na 时，表示数组末尾。

---

first

Array.first(id: Array<T>): T

返回给定 array 的第一个元素。

参数

名称	类型	默认值	说明
id	Array<T>		要从中检索第一个元素的数组。

返回: T

---

get

Array.get(id: Array<T>, index: int): T

返回给定 array 中指定 index 处的元素。

参数

名称	类型	默认值	说明
id	Array<T>		要从中检索元素的数组。
index	int		要检索的元素的索引。

返回: T

---

includes

Array.includes(id: Array<T>, value: T): bool

检查给定的 array 是否包含指定的 value。如果在数组中找到该值，则返回 true，否则返回 false。

参数

名称	类型	默认值	说明
id	Array<T>		要搜索的数组。
value	T		要搜索的值。

返回: bool

---

indexof

Array.indexof(id: Array<T>, value: T): int

返回指定 value 在给定 array 中第一次出现的索引。如果没有找到该值，则返回-1。

参数

名称	类型	默认值	说明
id	Array<T>		要搜索的数组。
value	T		要搜索的值。

返回: int — 第一次出现的从零开始的索引，如果未找到则为 -1。

---

insert

Array.insert(id: Array<T>, index: int, value: T)

将指定的 value 插入到 array 中给定的 index 处，并将后续元素向右移动。

参数

名称	类型	默认值	说明
id	Array<T>		要修改的数组。
index	int		要插入值的索引。
value	T		要插入的值。

---

join

将给定 array 的元素连接成单个字符串，每个元素由指定的 separator 分隔。

参数

名称	类型	默认值	说明
id	Array<int>		要连接的整数数组。
separator	string		放置在元素之间的分隔符字符串。

返回: string

将给定 array 的元素连接为一个字符串，每个元素之间使用指定的 separator 分隔。

参数

名称	类型	默认值	说明
id	Array<float>		要加入的浮点数组。
separator	string		放置在元素之间的分隔符字符串。

返回: string

将给定 array 的元素连接为一个字符串，每个元素之间使用指定的 separator 分隔。

参数

名称	类型	默认值	说明
id	Array<string>		要连接的字符串数组。
separator	string		放置在元素之间的分隔符字符串。

返回: string

---

last

Array.last(id: Array<T>): T

返回给定 array 的最后一个元素。

参数

名称	类型	默认值	说明
id	Array<T>		要从中检索最后一个元素的数组。

返回: T

---

lastindexof

Array.lastindexof(id: Array<T>, value: T): int

返回指定 value 在给定 array 中最后一次出现的索引。如果没有找到该值，则返回-1。

参数

名称	类型	默认值	说明
id	Array<T>		要搜索的数组。
value	T		要搜索的值。

返回: int — 最后一次出现的从零开始的索引，如果未找到则为 -1。

---

max

返回给定 array 中的 nth 最大值。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
nth	int	0	返回哪个最大值（0 表示最大，1 表示第二大，等等）。

返回: int

返回给定 array 中的第 n 个最大值。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
nth	int	0	返回哪个最大值（0 表示最大，1 表示第二大，等等）。

返回: float

---

median

返回给定 array 中元素的中值。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。

返回: float

返回中位数。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。

返回: float

---

min

返回给定 array 中的 nth 最小值。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
nth	int	0	返回哪个最小值（0 表示最小，1 表示第二小，等等）。

返回: int

返回给定 array 中的第 n 个最小值。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
nth	int	0	返回哪个最小值（0 表示最小，1 表示第二小，等等）。

返回: float

---

mode

该函数返回数组元素的众数。如果有多个值具有相同的频率，则返回最小值。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。

返回: int — 最常出现的值，或相关值中最小的值。

返回数组元素的众数。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。

返回: float — The most frequently occurring value, or the smallest among tied values.

---

percent_rank

返回给定 array 中指定 index 处元素的百分位数排名。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
index	int		元素的索引。

返回: float — 0 到 100 之间的值，表示小于或等于 index 处的元素的百分比。

返回给定 array 中指定 index 处元素的百分位数排名.

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
index	int		元素的索引。

返回: float — A value between 0 and 100 indicating the percentage of elements that are less than or equal to the element at index.

---

percentile_linear_interpolation

使用线性插值从给定 array 返回指定 percentile 处的值。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
percentage	float		百分位值 (0-100)。

返回: float

使用线性插值返回百分位数的值。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
percentage	float		百分位值 (0-100)。

返回: float

---

percentile_nearest_rank

使用最近排序方法从给定的 array 返回指定 percentile 处的值。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
percentage	float		百分位值 (0-100)。

返回: float

返回具有最接近排名的百分位值。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
percentage	float		百分位值 (0-100)。

返回: float

---

pop

Array.pop(id: Array<T>): T

删除并返回给定 array 中的最后一个元素。

参数

名称	类型	默认值	说明
id	Array<T>		从中弹出元素的数组。

返回: T

---

push

Array.push(id: Array<T>, value: T)

将给定的 value 附加到 array 的末尾。

参数

名称	类型	默认值	说明
id	Array<T>		将附加值的数组。
value	T		要附加到数组的值。

---

range

返回给定 array 中元素的范围（最大值和最小值之间的差）。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。

返回: int

返回给定 array 中元素的范围（最大值与最小值之差）。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。

返回: float

---

remove

Array.remove(id: Array<T>, index: int): T

从给定的 array 中删除指定 index 处的元素并返回删除的元素。

参数

名称	类型	默认值	说明
id	Array<T>		要修改的数组。
index	int		要删除的元素的索引。

返回: T

---

reverse

Array.reverse(id: Array<T>)

反转给定 array 中元素的顺序。

参数

名称	类型	默认值	说明
id	Array<T>		要反转的数组。

---

set

Array.set(id: Array<T>, index: int, value: T)

将数组中指定索引处的元素设置为提供的值。如果索引为正，则该函数从数组的开头开始计数（从 0 开始），如果索引为负，则从数组的末尾开始计数（-1 是最后一个元素）。例如，对于包含 [10, 20, 30] 的数组，以下所有索引均有效：0、1、2、-1、-2、-3。

参数

名称	类型	默认值	说明
id	Array<T>		要修改的数组。
index	int		元素的索引（支持负索引）。
value	T		要在指定索引处设置的值。

---

shift

Array.shift(id: Array<T>): T

删除并返回给定 array 中的第一个元素。

参数

名称	类型	默认值	说明
id	Array<T>		要从中移动元素的数组。

返回: T

---

size

Array.size(id: Array<T>): int

返回给定 array 的大小（元素数量）。

参数

名称	类型	默认值	说明
id	Array<T>		待确定大小的数组。

返回: int

---

slice

Array.slice(id: Array<T>, index_from: int = 0, index_to: int = na): Array<T>

创建一个新数组，该数组是给定 array 的一部分，从 index_from 到 index_to。

参数

名称	类型	默认值	说明
id	Array<T>		要切片的数组。
index_from	int	0	起始索引（含）。
index_to	int	na	结束索引（不包括）。当 na 时，表示数组末尾。

返回: Array<T>

---

some

检查给定布尔值 array 中是否至少有一个元素是 true。如果任何元素是 true，则返回 true，否则返回 false。

参数

名称	类型	默认值	说明
id	Array<bool>		要检查的数组。

返回: bool

检查给定 array 中是否至少有一个元素求值为 true。

参数

名称	类型	默认值	说明
id	Array<int>		要检查的数组。

返回: bool

检查给定 array 中是否至少有一个元素求值为 true。

参数

名称	类型	默认值	说明
id	Array<float>		要检查的数组。

返回: bool

---

sort

按升序或降序对给定 array 的元素进行排序。

参数

名称	类型	默认值	说明
id	Array<int>		要排序的整数数组。
order	any	SortOrder.Ascending	排序顺序。

对数组元素进行排序。

参数

名称	类型	默认值	说明
id	Array<float>		要排序的浮点数组。
order	any	SortOrder.Ascending	排序顺序。

对数组元素进行排序。

参数

名称	类型	默认值	说明
id	Array<string>		要排序的字符串数组。
order	any	SortOrder.Ascending	排序顺序。

---

sort_indices

返回对给定 array 进行排序的索引数组。

参数

名称	类型	默认值	说明
id	Array<int>		要分析的整数数组。
order	any	SortOrder.Ascending	排序顺序。

返回: Array<int> — 重新排列原始索引的数组，以便 array.get(result.get(i)) 产生第 i 个排序元素。

返回排序索引。

参数

名称	类型	默认值	说明
id	Array<float>		要分析的浮点数数组。
order	any	SortOrder.Ascending	排序顺序。

返回: Array<int>

返回排序索引。

参数

名称	类型	默认值	说明
id	Array<string>		要分析的字符串数组。
order	any	SortOrder.Ascending	排序顺序。

返回: Array<int>

---

standardize

通过减去平均值并除以标准差来标准化给定 array 的元素。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。

返回: Array<float> — 一个新数组，其中每个元素都是 (value - mean) / stdev （z 分数）。

通过减去均值并除以标准差来标准化给定 array 的元素。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。

返回: Array<float> — 返回一个新数组，其中每个元素都是 (value - mean) / stdev（z 分数）。

---

stdev

计算给定 array 中元素的标准差。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

计算给定 array 元素的标准差。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

---

sum

计算给定 array 中元素的总和。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。

返回: int

计算给定 array 中元素的总和。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。

返回: float

---

unshift

Array.unshift(id: Array<T>, value: T)

将指定的 value 添加到给定 array 的开头。

参数

名称	类型	默认值	说明
id	Array<T>		要修改的数组。
value	T		要添加到开头的值。

---

variance

计算给定 array 中元素的方差。

参数

名称	类型	默认值	说明
id	Array<int>		输入整数数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float

计算给定 array 元素的方差。

参数

名称	类型	默认值	说明
id	Array<float>		输入浮点数数组。
biased	any	true	如果是 true，则函数使用有偏估计（除以 n）；如果是 false，则使用无偏估计（除以 n-1）。

返回: float