find()

概要

一覧から検索条件を満たす項目を返します。最も単純な形式では、項目と一致する一覧 inList から最初の項目が返されます。inList の各エントリに適用される関数名であるキーを指定すると、より役立ちます。条件を満たすエントリがない場合、NoValue が返されます。

構文

find ( item As Any, _
       inList As List, _
       Optional key As Any ) As Any 

引数	[タイプ]	説明
item	すべて	検索が成功するために一致する必要のある値です。
inList	[一覧]	候補の一覧です。一致する最初のものだけが返されます。

オプションの引数

Name	[タイプ]	既定値	説明
key	すべて	Identity	任意指定。比較の前に inList の各エントリに適用される関数の名前です。既定は:Identity です。

例 1

Intent >find(3, {1, 2, 3}) 
--> 3 

例 2

Intent >find(7, {4, 8, 2}) 
--> NoValue 

例 3

Intent >find(9, {{3, 6, 9}, {9, 5, 6}, {9, 1, 2}}, key := :first) 
--> { 9, 5, 6} 

この例では、inList の各一覧の最初のメンバにのみ項目が比較されます。最初の一致のみが返されることに注意してください。

例 4

Intent >find("mary", {"peter", "paul", "mary"}) 
--> "mary" 

例 5

Intent >find(3, {{2, "lm"}, {3, "pq"}, {4, "xy"}}, key := :first) 
--> {3, "pq"}