検索（Find）

リストから、指定された条件を満たす最初のアイテムを見つけます。複雑な条件に基づく検索を行うには、Find Customを使用します。

入力

フィールド	定義	タイプ	必須
list	Find関数カードによる検索の対象となるリスト。	オブジェクトのリスト	TRUE
演算子	リストに対して実行される特定の比較（以下の関係演算子の表を参照）。	ドロップダウン	TRUE
パス	オブジェクトのリストを検索する場合、パス（path）は比較する値を保持しているキーの名前です。オブジェクト内にある別のオブジェクトへのパスを指定するには、ピリオドを使用します（例：`customer.id`）。テキスト、数値、または日付と時刻のリストを検索する場合は、このフィールドは空白のままにします。	文字列	FALSE
comparison	比較対象の値	文字列	TRUE

注意:

必ず入力リストと比較のtypeを設定して、比較の実行方法を指定します。たとえば、greater than演算子は、数値の場合は数値に基づいて比較を行いますが、テキストの場合はアルファベット順に基づいて比較を行います。したがって、80 > 9という数値の比較はtrueを返しますが、"80" > "9"というテキストの比較はfalseを返します。

アイテムの一致について、より多くのオプションが必要な場合は、Find Customを使用してください。リスト内で条件に一致するすべての要素を検索するには、FilterまたはFilter Customを使用してください。

出力

フィールド	定義	タイプ
アイテム	リスト内で、指定した条件を満たす最初のアイテム。	オブジェクト
インデックス	元のリストでアイテムの見つかった位置。リストの最初のアイテムは`0`です。一致するものが見つからなかった場合、`-1`を返します。	数値

関係演算子の表

演算子	ユースケース
equal to	2つのテキスト、数値、日付、またはtrue/falseを比較し、同じ値かどうかを調べます。
次と等しくない（not equal）	2つのテキスト、数値、日付、またはtrue/falseを比較し、異なる値かどうかを調べます。オブジェクトを比較するには、`doesn't have key`の代わりにこのオプションを使用します。
次より大きいか等しい（greater than or equal）	2つのテキスト、数値、または日付を比較し、最初のものが2番目のものと等しい、またはより大きいかどうかを調べます。
less than or equal	2つのテキスト、数値、または日付を比較し、最初のものが2番目のものと等しい、またはより小さいかどうかを調べます。
greater than	2つのテキスト、数値、または日付を比較し、最初のものが2番目のものより大きいかどうかを調べます。
less than	2つのテキスト、数値、または日付を比較し、最初のものが2番目のものより小さいかどうかを調べます。
次の倍数（a multiple of）	2つの数値を比較し、value aがvalue bの正確な倍数かどうかを調べます。たとえば、12、0、-4はすべて4の倍数ですが、2、3、7は倍数ではありません。
の（in）	2つのテキストを比較し、value aがvalue bの一部かどうかを調べます。たとえば、「test」は「this is a test」に含まれますが、「i」は「team」に含まれません。
次にない（not in）	2つのテキストを比較し、value aがvalue bに含まれていないかどうかを調べます。
キーがある（has key）	value aがオブジェクトで、value bがテキストのとき、そのオブジェクトに指定された名前のキーが存在するかどうかを調べます。たとえば、value aが{"test":123}で、value bが「test」なら、trueを返します。
キーがない（doesn't have key）	value aがオブジェクトで、value bがテキストのとき、そのオブジェクトに指定された名前のキーが存在しないかどうかを調べます。
空である（is empty）	value aが空かどうかを調べます。value bは無視されます。何を「空」と定義するかはタイプによって異なります。注：テキストとオブジェクトでのみ正しく動作します。数値、日付、T/Fは空と見なされます。
空でない（is not empty）	value aが空でないかどうかを調べます。注：テキストとオブジェクトでのみ正しく動作します。数値、日付、T/Fは空と見なされます。

例1

条件	結果
リスト（list）は`[1,22,30,4,35,46]` 演算子（operator）は`greater than` パス（path）は空白比較（comparison）は`30`	アイテム（item）は`35`（30より大きいリストの最初の数値）、インデックス（index）は`4`。

条件

結果

リスト（list）は[1,22,30,4,35,46]

演算子（operator）はgreater than

パス（path）は空白

比較（comparison）は30

アイテム（item）は35（30より大きいリストの最初の数値）、インデックス（index）は4。

例2

条件	結果
リスト（list）は`[{"name":"Bob","department":"Sales"}, {"name":"Sarah","department":"Engineering"}]` 演算子（operator）は`equal to` パス（path）は`department` 比較（comparison）は`Engineering`	アイテム（item）は`{"name":"Sarah","department":"Engineering"}` インデックス（index）は`1`（インデックス位置 1 にあるリストの最初のオブジェクト、departmentは`Engineering`）

条件

結果

リスト（list）は[{"name":"Bob","department":"Sales"}, {"name":"Sarah","department":"Engineering"}]

演算子（operator）はequal to

パス（path）はdepartment

比較（comparison）はEngineering

アイテム（item）は{"name":"Sarah","department":"Engineering"}

インデックス（index）は1（インデックス位置 1 にあるリストの最初のオブジェクト、departmentはEngineering）

同じチェックを行い、comparisonにMarketingを使用すると、一致するオブジェクトがないため結果のitemは{}、インデックス（index）は-1になります。