Replaces or updates the first item from a list that matches the given criteria with a new item. Returns a list where the matching item has been changed to the new value.
The criteria is defined as a formula at the 2nd parameter. The formula is evaluated with each item in the list until a matching item is found. The search formula must result in a true/false value. If true, then item will be excluded from the result, otherwise it will be included.
The 3rd parameter defines either the replacement value for the item, or a formula that can use the existing, matching item resulting in a new value. For example, the formula can use SET\_KEY function to update a property of a matching item to a new value.
Note that only first matching item is replaced; if multiple items matches the criteria, then only first one is changed. If no matching item is found, then the original list is returned unchanged.