How to add your knowledge

findInPlist()

    Table of contents
    1. 1. Synopsis
    2. 2. Syntax
    3. 3. Example 1
    4. 4. Example 2
    5. 5. Example 3

    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.