find()

Synopsis

Returns the item that meets your search criteria from a list. In its simplest form, it will return the first item from the list inList that matches item. It is more useful when you supply a key, which is a function name applied to each entry in inList. If no entry meets the criteria, NoValue is returned.

Syntax

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

Optional Arguments

Example 1

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

Example 2

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

Example 3

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

Example 4

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

Example 5

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