配列フォーマッタ

Version 25.3.9411


配列フォーマッタ


以下のフォーマッタは、入力として配列属性を想定しています。配列属性とは、アイテムの1つの属性に複数の値が割り当てられたものです。APIScript の配列属性は、属性の末尾のシャープ記号(#)で示されます(例えばtmp.myarrayitem# です)。詳しくは、アトリビュート値の選択を参照してください。

Notes

  • これらのフォーマッタのいずれかに配列属性を渡す場合は、# 記号は必要ありません。
  • 一部のフォーマッタのオプションパラメータを囲う角括弧は、必須ではありません。これらは、パラメータがオプションであることを示すためにあります。

arrayfind(substring)

属性配列で文字列が見つかったときのインデックスを返します。インデックスは1オリジンです。

  • searchstring:元の値で検索する文字列。

count(substring)

最初のパラメータで指定された部分文字列の属性値の出現回数を返します。

  • substring:属性値で検索する部分文字列。

endswith(substring[, iftrue][, iffalse])

属性値が指定されたパラメータで終わるかどうかを決定します。属性が値で終わっている場合は true (または iftrue )を返し、それ以外の場合は false (または iffalse )を返します。

  • substring:最後に期待される文字列。
  • iftrue:属性値がパラメータ値で終わる場合に返される値(オプション)。
  • iffalse:属性値がパラメータ値で終わらない場合に返される値(オプション)。

implode([separator])

複数の値を区切り文字で区切られた文字列に分解します。

  • separator:区切り文字(オプション)。

join([separator])

複数の値を区切り文字で区切られた文字列に結合します。

  • separator:区切り文字(オプション)。

match(pattern[, index][, option])

属性値で表される文字列から、pattern パラメータで指定された正規表現が出現しているものを検索します。

  • pattern:一致する正規表現パターン。
  • index:返す一致の番号付きインデックス(オプション)。デフォルトは0 です。
  • option:正規表現オプションのカンマ区切りリスト(オプション)。一般的に使用されるオプションは、IgnoreCase、Multiline、Singleline、およびIgnorePatternWhitespace です。

print([delim])

指定された区切り文字を使用して連結された属性のすべての値を含む文字列を返します。

  • delim:値を区切る区切り文字(オプション)。デフォルトはカンマです。