Searches a list to find a value and returns the index of the value in the list.
The name of the list to search. The list name should contain a pair of braces {}.
The string or regular expression to search in the list.
If the Index Attribute is specified and the search string is found, an attribute with the specified name will be added to the output feature containing the index of the found element.
This parameter determines how the list will be searched.
| Parameter Choice | Description |
|---|---|
|
First Exact Match |
Searches for an exact match. |
|
First regular expression match |
Uses a regular expression to search for a first matching entry in the list. Advanced Regular Expressions (AREs) are supported. Search the FME Functions and Factories for a complete description of AREs. In brief, an ARE is one or more branches, separated by `|', matching anything that matches any of the branches. |
|
First not matching |
Returns the index of the first non-matched entry in the list. |
|
First less than, |
Searches for the first element in the list that satisfies the criteria. Numerical comparisons are used if both the list element and the search value can be converted to floating point numbers; otherwise, string comparisons are used |
If checked, the contents of the found element will be copied to the main attribute(s) of the output feature. This saves adding a ListIndexer after the searcher to demote the list element.
Note that any list element attributes that start with fme_ will not be copied (for example, fme_type) unless you specify a Demoted Attribute Prefix.
The prefix that should be added to any attribute(s) copied onto the output feature.
For example, if this feature enters the transformer:
somelist{0}.length = 7.3
somelist{0}.kind = ’paved’
somelist{1}.length = 8.4
somelist{1}.kind = ’smooth’
somelist{1}.lanes = 2
somelist{2}.length = 1.1
somelist{2}.kind = ’rough’
and the somelist{}.kind list attribute
is searched for the value smooth, then the
index attribute would be set to 1.
Test regular expressions with Rubular, a Ruby-based regular expression editor.
Search for samples and information about this transformer on FMEpedia.