XML Functions (LR_XML) > Multiple Query Matching

Multiple Query Matching

The default behavior for all functions is to return only the first match found by an XML Query. However, XML functions have the ability to process all matches found. Depending on the task of the function (extract, find, set, etc.), the function can process each consecutive match it finds with the next parameter in a parameter set.

For example, if the function's task is to retrieve the value of all the matches (e.g., lr_xml_get_values), then the function will write each value it finds into the parameter set.

If the "SelectAll=yes" specification is passed as an argument, then elements matching the query will be saved in a series of parameters in the form:

Param_1, Param_2, Param_3, ...

where Param is the value "ValueParam=Param".

See Functions that write to a parameter set.

Other functions read values from the parameter set. For example, if the function's task is to set the value of the match (e.g., lr_xml_set_values), then the function will read the values of the parameters of the set into all matches it finds.

To use functions that read a parameter set:

See Functions that read a parameter set.