find()

概要

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

構文

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

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

オプションの引数

Name	[タイプ]	既定値	説明
key	Any	Identity	既定値は :IdentityinList の各エントリに比較の前に適用される関数の名前オプション。

例 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"}