FIND

Reference

Syntax

FIND [{FIRST OCCURRENCE}|{ALL OCCURRENCES} OF]
     {[SUBSTRING] sub_string} | {REGEX regex} IN
     { {[SECTION [OFFSET off] [LENGTH len] OF] dobj}
     | {TABLE itab [FROM lin1 [OFFSET off1]]
                   [TO   lin2 [OFFSET off2]]} }
     [IN {BYTE|CHARACTER} MODE]
     [{RESPECTING|IGNORING} CASE]
     [MATCH COUNT  mcnt]
     { {[MATCH LINE   mlin]
        [MATCH OFFSET moff]
        [MATCH LENGTH mlen]}
     | [RESULTS result_tab|result_wa] }
     [SUBMATCHES s1 s2 ...].

Effect:

Searches for byte or character strings or for regular expressions in a byte-type or character-type data object dobj or in an internal table itab.

Additions

• {FIRST OCCURRENCE}|{ALL OCCURRENCES OF}
  Determines whether the search looks for only first occurrence
  or all occurrences.
  
  
• {[SUBSTRING] sub_string} | {REGEX regex}
  Determines whether the search looks for a substring sub_string or a regular expression regex.
  
  
• SECTION [OFFSET off] [LENGTH len] OF dobj
  Search in a byte or character string dobj with restriction of the search range to the section starting from the offset specified in off with the length specified in len.
  
  
• TABLE itab [FROM lin1 [OFFSET off1]] [TO lin2 [OFFSET off2]]
  Search in an internal table itab with restriction of the search range to the section starting from the line specified in lin1 with the offset specified in off1 until the line specified in lin2 with the offset specified in off2.
  
  
• IN {BYTE|CHARACTER} MODE
  Determines byte or character string processing.
  
  
• {RESPECTING|IGNORING} CASE
  Determines whether upper/lower case is taken into account in sub_string, regex, and dobj.
  
  
• MATCH COUNT mcnt
  Returns the number of found locations in mcnt.
  
  
• MATCH LINE mlin
  When searching in internal tables, returns the line number of the last found location in mlin.
  
  
• MATCH OFFSET moff
  Returns the offset of the last found location in moff.
  
  
• MATCH LENGTH mlen
  Returns the length of the last found substring in mlen.
  
  
• RESULTS result_tab|result_wa
  Returns the properties of all found locations or the last found location in an internal table result_tab or a structure result_wa.
  
  
• SUBMATCHES s1 s2 ...
  When searching for regular expressions, returns the contents of the subgroup registers of the last found location in s1, s2, ....