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