Syntax: @wfattrvals(attribute_pattern_list[, name_pattern_list, page_name_list, attribute_search_options])
Argument1: pattern string list, attribute_pattern_list
Argument2: pattern string list, name_pattern_list
Argument3: string list, page_name_list
Argument4: int, attribute_search_options
The attribute_search_options is an integer value indicating how a “*” in the attribute_pattern should be treated when matching. Use “0” to treat “*” as a wildcard and “1” to treat “*” as a literal. The default is “0”.
Return: string list
Returns a string list of all attribute values that satisfy the attribute_pattern_list and, optionally, the object name_pattern_list and page_name_list. The attribute_pattern_list may be made up of any number of “?” (indicates any single character) or “*” (indicates any number of characters). If a page_name_list is not specified the current workfile page is used.
Examples
If a workfile contains three objects named “PAGE1”, “PAGE2”, and “PAGE3”, then
@wfattrvals("M*",”*”, “PAGE1”)
return the string list of all attribute values that begin with “M” on PAGE1. Alternatively,
@wfattrvals("M* D*", “GDP”, “PAGE1 PAGE2”)
returns the list of attribute values for the objects PAGE1/GDP and PAGE2/GDP that begin with “M” and “S”.
If on PAGE1 there was an object that had one attribute value of “*Mar” and second attribute value of “Mar”, the command
@wfattrvals("*mar", “*”, “PAGE1”)
will return “*mar mar”. This is because the “*” in “*mar” is treated as a wildcard and the value “Mar” and value “*Mar” from the two different values match. However, the command
@wfattrvals("*mar", “*”,”PAGE1”, 1)
will only return “*mar”, since the “*” in “*Mar” is treated as a literal and only “*Mar” from one of the attributes match.