配列およびオブジェクトの式

Prev Next

式エディタでの配列やオブジェクトの操作の基本を学びましょう。

Tulipでデータを扱うには、配列を操作するためにどの式を使用すべきかを理解することが不可欠です。また、式を使用してオブジェクトを個別のデータ型に分解することもできます。これにより、特定のデータに焦点を当て、アプリケーション内のプロセスを最適化することが可能になります。


配列を用いた式

値を取得するために、さまざまな機能を持つ数種類の式があります。これらの値は、単一の値でも、別の配列でもかまいません。また、同じデータ型でも、異なるデータ型でもかまいません。

一部の式では、配列を使用して単純な算術値を返します:

array_max():指定された数値配列の最大値を返します。

array_max expression

**array_min()**指定された数値配列の最小値を返します。

array_min expression

array_avg():指定された数値配列の平均値を返します。

array_avg expression

Array Expressions - Max Min Avg

その他の式では、標準偏差を使用して値を返します。

**array_stdev_population()**指定された数値配列の母集団の標準偏差を返します。

array_stdev_population expression

**array_stdev_sample()**指定された数値配列の標本から標準偏差を返します。

array_stdev_sample expression

Array Expressions  - StDev Pop Samp

array_at_value_index:指定されたリストの指定されたインデックスにある値を返します。インデックスが範囲外の場合は、null を返します。

array_value_at_index ex

Tulipプラットフォームで最も広く使用されている式の一つは次のとおりです:

**array_index_of()**指定された配列内で、指定された値が最初に現れるインデックスを返します。見つからない場合は「-1」を返します。

array_index_of expression

Array_Index_Of Ex

このコミュニティの投稿で説明されているように、array_index_of() を使用すると、シリアルドライバ上の COM ポートを特定できます。また、コネクタの出力結果から特定の作業指示書を見つける際にも使用できます。

LEN():配列内の要素数を返します。Len expression ex

また、配列を使用して特定の値を判定する式もあります。例えば、次のようなものです。

arraycontains():指定された値が指定された配列に含まれている場合は「true」を返し、そうでない場合は「false」を返します。

arraycontains expression yes

Array Expressions - Contains

以下の式は、正規表現を使用して配列を返します。このチートシートを参照して、正規表現の機能や構文を理解することもできます。

regex_match():正規表現に一致する項目の配列を返します。

regex_match expression ex

regex_match expression ex in app

regex_replace():式で定義された文字列置換が適用された配列を返します。

regex_replace expression ex

regex_replace expression ex in app

最後に、データ型が類似した複数の配列を結合して、新しい配列を作成することができます。

**array_concat()**単一の型を持つ任意の数の配列を、その型の単一の配列に連結します。

Array_Concat Expression

Array_Concat Ex

オブジェクトを含む式

Tulip では、オブジェクトを使用する式はすべて同じ機能を持っています。つまり、あるオブジェクトからデータを収集し、単一のデータ型を使用する別のオブジェクトに格納します。以下の式は同様に機能し、指定されたキー(ヘッダー)を使用して、オブジェクト配列を基本配列に変換します。

**map_to_boolean_list()**指定されたキーについて、オブジェクト配列をブール値の配列に変換します。map_to_boolean_list ex

**map_to_integer_list()**指定されたキーに基づいて、オブジェクト配列を Integer 配列に変換します。map_to_integer_list ex

**map_to_number_list()**オブジェクトの配列を、指定されたキーに対する数値の配列に変換します。

map_to_number_list ex

**map_to_text_list()**オブジェクトの配列を、指定されたキーに対応するテキストの配列に変換します。map_to_text_list ex

以下の例では、オブジェクト配列にはオブジェクトごとに 4 つのデータ見出しがあります。ボタントリガーはデータ操作を使用して、各キー(見出し)のデータをそれぞれの変数配列(ブール値、数値など)に格納します。

map to text ex in app

上記の map_to_text 式を array_index_of() と組み合わせて使用することで、コネクタ関数 Output から情報を抽出できます。