ABAP Keyword Documentation →  ABAP - Short Reference 

READ TABLE itab - Short Reference

Reference

Other versions: 7.31 | 7.40 | 7.54

Syntax

READ TABLE itab 
           { {{FROM wa [USING KEY key_name|(name)]} 

             |{WITH TABLE KEY [key_name|(name) COMPONENTS] 

                 
            {comp_name1|(name1)} = dobj1 

                 
            {comp_name2|(name2)} = dobj2 

                              ...} 

             | {WITH KEY comp1 = dobj1 comp2 = dobj2 ... [BINARY SEARCH]} 

             | {WITH KEY key_name|(name) 

                         COMPONENTS comp1 = dobj1 comp2 = dobj2 ... } 

             | {INDEX idx [USING KEY key_name|(name)]} } 

             | {WITH KEY dobj} 
 
           | {WITH KEY = dobj [BINARY SEARCH]} } 
           { {INTO wa 

              [COMPARING { {comp1 comp2 ...}|{ALL FIELDS}|{NO FIELDS} }] 

              [TRANSPORTING { {comp1 comp2 ...}|{ALL FIELDS} }]} 

           | {ASSIGNING <fs> [CASTING]} 
           | {REFERENCE INTO dref} 

           | {TRANSPORTING NO FIELDS} }. 

Effect

Reads a single line from an internal table itab.

Additions

• FROM wa
  Specifies the line to be read by matching it with the key values of a work area wa.
• WITH TABLE KEY {comp_name1|(name1)} = dobj1 {comp_name2|(name2)} = dobj2 ...
  Specifies the line to be read by static or dynamic specification of components of the primary table key.
• WITH KEY comp1 = dobj1 comp2 = dobj2 ... [BINARY SEARCH]
  Specifies the line to be read by specification of any components comp1, comp2, ..., and appropriately sorted standard tables are searched using a binary search BINARY SEARCH.
• WITH KEY [key_name|(name) COMPONENTS] comp1 = dobj1 comp2 = dobj2 ...
  Specifies the line to be read by specification of components comp1, comp2, ... for a table key.
• INDEX idx
  Specifies the line to be read by specification of the line number idx of a table index.
• KEY key_name|(name)
  Specifies (statically or dynamically) a (secondary) table key used to find the line to be read.
• WITH KEY dobj
  Obsolete: reads the first line for which the left-aligned content matches the content of the data object dobj, and the table line is castt to the type of dobj.
• WITH KEY = dobj [BINARY SEARCH]
  Obsolete: reads the first line whose total content matches the content of the data object dobj, whereby apppropriately sorted tables are sorted using a BINARY SEARCH binary search.
• INTO wa
  Assigns the read line to a work area wa.
• COMPARING { {comp1 comp2 ...}|{ALL FIELDS}|{NO FIELDS} }
  Compares the components comp1, comp2, ... , all components, or no components of a found line with the corresponding components of the work area, and sets sy-subrc accordingly.
• TRANSPORTING { {comp1 comp2 ...}|{ALL FIELDS} }
  Assigns the specified components comp1, comp2, ... or all components of the found line to the work area wa.
• ASSIGNING <fs> [CASTING]
  Assigns the line read to a field symbol <fs>; casting be carried out.
• REFERENCE INTO dref
  Assigns the reference to the read line to a reference variable dref.
• TRANSPORTING NO FIELDS
  The read line is not assigned.