Syntax

   @SearchList(<listName>, <value>, [FIRST_MATCH|FIRST_NOT_MATCHED|
      REGULAR_EXPRESSION|REGULAR_EXPRESSION_ENCODED|FIRST_NOT_MATCHED_ENCODED|
      FIRST_MATCHED_ENCODED|FIRST_LESS_THAN_ENCODED|FIRST_GREATER_THAN_ENCODED|
      FIRST_LESS_THAN_OR_EQUAL_ENCODED|FIRST_GREATER_THAN_OR_EQUAL_ENCODED], [CASE_SENSITIVE|CASE_INSENSITIVE]) 

      @SearchList([fme_encoded,]<listName>,<value>,[FIRST_MATCH|FIRST_NOT_MATCHED|
      REGULAR_EXPRESSION|REGULAR_EXPRESSION_ENCODED|FIRST_NOT_MATCHED_ENCODED|
      FIRST_MATCHED_ENCODED|FIRST_LESS_THAN_ENCODED|FIRST_GREATER_THAN_ENCODED|
      FIRST_LESS_THAN_OR_EQUAL_ENCODED|FIRST_GREATER_THAN_OR_EQUAL_ENCODED], [CASE_SENSITIVE|CASE_INSENSITIVE])

Arguments

   <fme_encoded>
      
      When specified, it means that all the arguments are FMEParsableText encoded

   <listName>  
   
      The function searches this attribute list for the <value>. The list name 
      should contain a {} pair to indicate it is a list.
   
      Range: Any Feature Attribute List   
      
   <value>  
   
      The function searches the attribute list for this value. 
   
      Range: String or Number 
      
   <search type>  
   
      If there is no value specified or it is FIRST_MATCH, then the first 
      matching list entry's index is returned. If it is FIRST_NOT_MATCHED, then 
      the first non-matching list entry's index is returned. The search type 
      REGULAR_EXPRESSION is like FIRST_MATCH but it uses the regular expression 
      to find a match.
      
         Note: Some special characters such as "@" and "&" have special meanings 
         in FME and may not produce expected results if used in the regular 
         expression string. 
   
      Range: FIRST_MATCH|FIRST_NOT_MATCHED|REGULAR_EXPRESSION  
      
   <search type> (ENCODED options)  
   
      Expands on the search types above to allow special characters to be used 
      in the search string. For more information, search Substituting Strings in 
      Mapping Files in the FME Fundamentals manual online help file.

      Range: REGULAR_EXPRESSION_ENCODED|FIRST_NOT_MATCHED_ENCODED|
         FIRST_MATCHED_ENCODED|FIRST_LESS_THAN_ENCODED|
         FIRST_GREATER_THAN_ENCODED|FIRST_LESS_THAN_OR_EQUAL_ENCODED|
         FIRST_GREATER_THAN_OR_EQUAL_ENCODED 

   <case sensitivity>

      Indicates whether the search should be done in a case-sensitive or case-
      insensitive manner. If no value is provided, the search will be case-sensitive.

      Range: CASE_SENSITIVE|CASE_INSENSITIVE
      
Description

   This function searches the attribute list given as its first parameter for 
   the value passed in as the second parameter. It will return the index of the 
   first matching list entry or -1 if no match is found.

   For example, if this feature enters this function:

      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' 
   with the Search Type set to FIRST_MATCH, then the index attribute would be 
   set to 1.

   If search type is FIRST_MATCH, it uses a regular expression to search for a 
   first matching entry in the list.

   If search type is FIRST_NOT_MATCHED, it will return the index of the first 
   non-matched entry in the list.

   Advanced Regular Expressions (AREs) are supported. Search the FME Functions 
   and Factories on-line help 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_LESS_THAN_ENCODED, FIRST_GREATER_THAN_ENCODED, 
   FIRST_LESS_THAN_OR_EQUAL_ENCODED, FIRST_GREATER_THAN_OR_EQUAL_ENCODED 
   similarly search 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. When any of the ENCODED options are used, additional 
   special characters are supported. For more information, search Substituting 
   Strings in Mapping Files in the FME Fundamentals manual online help file.