findInPlist()

Synopsis

Returns the value following the name in the list . If the name is not found in the list , or no value follows the name, NoValue is returned.

PList is shorthand for "Property List", which a list of name-value pairs. The name is called the indicator.

Syntax

findInPlist ( indicator As Name, _
              plist As List ) As Any 

Argument	Type	Description
indicator	Name	The name to find in plist. The value following the first name to match will be returned.
plist	List	A list of name/value pairs - commonly referred to as a property list .

Example 1

Intent >findInPlist(:b, {:a, 1, :b, 2, :c, 3}) 
--> 2 

Example 2

Intent >findInPlist(:d, {:a, 1, :b, 2, :c, 3}) 
--> NoValue 

The name 'd' is not found in the list .

Example 3

Intent >findInPlist(:d, {:a, 1, :b, 2, :c, 3, :d}) 
--> NoValue 

The name 'd' is found in the list , but no value follows to be returned.