陣列函式

最後更新： 2025年4月21日
  • 主題：

聯結（陣列；分隔符號）

在每個專案之間使用指定的分隔符號，將陣列中的所有專案串連到字串中。

長度（陣列）

傳回陣列中的專案數。

鍵（物件）

傳回給定物件或陣列屬性的陣列。

磁碟片段（陣列；開始；[結束]）

傳回僅包含所選專案的新陣列。

合併(array1； array2； …)

將一個或多個陣列合併到一個陣列中。

包含（陣列；值）

驗證陣列是否包含值。

移除（陣列；值1；值2； …）

移除陣列引數中指定的值。 此函式僅對文字或數字的原始陣列有效。

新增（陣列；值1；值2； …）

將引數中指定的值加入陣列並傳回該陣列。

對應（複雜陣列；機碼；[用於篩選的機碼]；[用於篩選的可能值]）

傳回包含複雜陣列值的原始陣列。 此函式允許篩選值。 將原始變數名稱用於金鑰。

範例：

  • map(Emails[];email)

    傳回包含電子郵件的基本陣列

  • map(Emails[];email;label;work;home)

    傳回原始陣列，其中包含標籤等於工作或住家位置的電子郵件

如需詳細資訊，請參閱對應陣列或陣列元素。

隨機播放

排序（陣列；[順序]；[索引鍵]）

排序陣列的值。 order引數的有效值為：

  • asc

    （預設） — 遞增順序： 1、2、3、…代表型別「數字」。 A， B， C， a， b， c， …適用於文字

  • desc

    遞減順序： …， 3， 2， 1代表型別Number。…， c， b， a， C， B， A代表文字。

  • asc ci

    不區分大小寫的遞增順序：A、a、B、b、C、c…代表文字型別。

  • desc ci

    不區分大小寫的遞減順序： …， C， c， B， b， A，代表文字型別。

使用key引數來存取複雜物件內的屬性。

將原始變數名稱用於金鑰。

若要存取巢狀屬性，請使用點標籤法。

陣列中的第一個專案是索引1。

範例：

  • sort(Contacts[];name)

    以預設遞增順序依「name」屬性來排列連絡人陣列

  • sort(Contacts[];desc;name)

    依「name」屬性以遞減順序來排列連絡人陣列

  • sort(Contacts[];asc ci;name)

    以不區分大小寫的遞增順序依「name」屬性來排列連絡人陣列

  • sort(Emails[];sender.name)

    依「sender.name」屬性排序電子郵件陣列

反向（陣列）

陣列中的第一個元素會成為最後一個元素，第二個元素會成為倒數第二個元素，依此類推。

平面化（陣列）

建立一個新陣列，將所有子陣列元素以遞回方式串連到其中，直到指定的深度。

distinct （陣列；[索引鍵]）

移除陣列內的重複專案。 使用"key"引數來存取複雜物件內的屬性。 若要存取巢狀屬性，請使用點標籤法。 陣列中的第一個專案是索引1。

範例： distinct(Contacts[];name)

透過比較「name」屬性來移除連絡人陣列內的重複專案

toCollection

  • 此函式接受包含機碼值組的陣列，並將其轉換為集合。 函式有3個引數：

  • （陣列）包含鍵值組

  • （字串）要當作索引鍵使用的欄位名稱

  • （字串）要當作值使用的欄位名稱