配列関数

最終更新日： 2025年4月21日
  • トピック：

join (array; separator)

各項目間に指定された区切り記号を使用して、配列のすべての項目を文字列に連結します。

length (array)

配列内の項目の数を返します。

keys (object)

指定されたオブジェクトまたは配列のプロパティの配列を返します。

slice (array; start; [end])

選択された項目のみを含む新しい配列を返します。

merge (array1; array2; …)

1 つまたは複数の配列を 1 つの配列に結合します。

contains (array; value)

配列に値が含まれているかどうかを確認します。

remove (array; value1; value2; …)

配列のパラメーターに指定された値を削除します。この関数は、テキストまたは数値のプリミティブ配列に対してのみ有効です。

add (array; value1; value2; …)

パラメーターで指定された値を配列に追加し、その配列を返します。

map (complex array; key;[フィルタリング用キー];[フィルタリングに使用可能な値])

複素配列の値を含むプリミティブ配列を返します。この関数を使用すると、値をフィルターできます。キーには変数名を使用します。

例：

  • map(Emails[];email)

    メールを含むプリミティブ配列を返します

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

    職場または自宅に等しいラベルを持つメールのプリミティブ配列を返します。

詳しくは、「 配列または配列要素のマッピング」を参照してください。

シャッフル

sort (array; [order]; [key])

配列の値を並べ替えます。order パラメーターの有効な値は次のとおりです。

  • asc

    （デフォルト）ー 昇順：番号タイプの場合は 1、2、3、…。A、B、C、a、b、c、…テキスト型の場合

  • desc

    降順：番号型の場合は　…、3、2、1。テキスト型の場合は …、c、b、a、C、B、A。

  • asc ci

    大文字と小文字を区別しない昇順：テキスト型の場合は A、a、B、b、C、c、…。

  • desc ci

    大文字と小文字を区別しない降順：テキスト型の場合は …、C、c、B、b、A、a。

key パラメーターを使用して、複雑なオブジェクト内のプロパティにアクセスします。

キーには変数名を使用します。

ネストされたプロパティにアクセスするには、ドット表記を使用します。

配列内の最初の項目はインデックス 1 です。

例：

  • sort(Contacts[];name)

    連絡先の配列を「名前」プロパティによってデフォルトの昇順で並べ替えます。

  • sort(Contacts[];desc;name)

    連絡先の配列を「名前」プロパティで降順に並べ替えます

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

    連絡先の配列を「名前」プロパティによって大文字と小文字を区別しない昇順で並べ替えます。

  • sort(Emails[];sender.name)

    メールの配列を「sender.name」プロパティで並べ替えます。

reverse (array)

配列の最初の要素が最後の要素になり、2 番目の要素が最後から 2 番目の要素になります。

flatten (array)

すべてのサブ配列要素が再帰的に連結された新しい配列を、指定された深さまで作成します。

distinct (array; [key])

配列内の重複を削除します。複雑なオブジェクト内のプロパティにアクセスするには、「キー」引数を使用します。ネストされたプロパティにアクセスするには、ドット表記を使用します。配列内の最初の項目はインデックス 1 です。

例：distinct(Contacts[];name)

「名前」プロパティを比較して、連絡先の配列内の重複を削除します。

toCollection

  • この関数は、キーと値のペアを含む配列を受け取り、コレクションに変換します。 関数には、次の 3 つの引数があります。

  • （配列）キーと値のペアを含む

  • （string）キーとして使用するフィールドの名前

  • （string）値として使用するフィールド名