Ansicht
Dokumentation

ABAPSEARCH_ITAB - SEARCH ITAB

ABAPSEARCH_ITAB - SEARCH ITAB

Fill RESBD Structure from EBP Component Structure   TXBHW - Original Tax Base Amount in Local Currency  
This documentation is copyright by SAP AG.
SAP E-Book

SEARCH itab

Short Reference



SEARCH itab FOR pattern $[IN ${CHARACTER$|BYTE$} MODE$]
       $[STARTING AT idx1$] $[ENDING AT idx2$]
       $[ABBREVIATED$]
       $[AND MARK$].

Additions

1. ... IN ${CHARACTER$|BYTE$} MODE

2. ... $[STARTING AT idx1$] $[ENDING AT idx2$]

3. ... ABBREVIATED

4. ... AND MARK

Effect

This statement searches the lines of the index table itab for a pattern specified in pattern. SEARCH cannot be used for hashed tables and not for tables with secondary table keys. The statement always searches the internal table and does not search any header line that might exist.

For pattern, a character-like or byte-like data object can be specified, depending on the processing type. The pattern in pattern can have the same forms as the statement SEARCH has for character-like or byte-like string processing.

The search is terminated at the first hit and sy-tabix is set to the index of the table line found. sy-fdpos is set to the offset of the character string or byte string found or word found in the table line. If the pattern is not found, sy-fdpos and sy-tabix are set to 0.

Return Value

sy-subrc Meaning
0 Pattern found in itab.
4 Pattern not found in itab.

Notes

  • Instead of the statement SEARCH, the statement FIND IN TABLE should be used whenever possible.

Addition 1

... IN ${CHARACTER$|BYTE$} MODE

Effect

The addition IN CHARACTER MODE or IN BYTE MODE is used to determine whether character or byte string processing is performed. The line type of the internal table must be suitable for the selected processing type. If no addition is specified, the search is performed character by character.

Addition 2

... $[STARTING AT idx1$] $[ENDING AT idx2$]

Effect

The additions STARTING AT and ENDING AT can be used to restrict the search to just some of the table lines of table itab. idx1 and idx2 expect data objects of the type i. The value in idx1 specifies from which line and to which line the value idx2 is searched for. If only one of the additions is specified, the search is performed from the first to the last line.

The search is not performed and sy-subrc is set to 4, if:

  • the value of idx1 or idx2 is less than 1
  • the value of idx1 is greater than the number of lines in itab
  • the value of idx2 is less than the value of idx1

Addition 3

... ABBREVIATED

Effect

In character-like searches, it is possible to specify an abbreviated pattern in pattern for character string processing by using the addition ABBREVIATED, like in the statement SEARCH.

Addition 4

... AND MARK

Effect

When searching character by character, it is possible to transform a character string or a word found in itab to uppercase using the statement AND MARK (just as with the statement SEARCH for character string processing).

Example

The search character by character is successful and sets sy-tabix to the index (2) of the corresponding line and sy-fdpos to the offset (7) of the word "see" in the line. After the statement is executed, the second table line contains the content "you'll SEE the line" specified by the addition AND MARK.






rdisp/max_wprun_time - Maximum work process run time   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
This documentation is copyright by SAP AG.

Length: 6858 Date: 20240420 Time: 000740     sap01-206 ( 82 ms )