Sie sind auf Seite 1von 2

ABAP Keyword Documentation

SAP NetWeaver AS ABAP Release 731, ©Copyright 2011 SAP AG. All rights reserved.

ABAP Keyword Documentation ABAP - Reference Processing Internal Data Internal Tables Processing Statements for Internal Tables

READ TABLE itab

Short Reference

for Internal Tables → READ TABLE itab Short Reference Syntax READ TABLE itab { table_key Effect

Syntax

READ TABLE itab { table_key

Effect

| free_key

| index } result.

This statement reads a row from the internal table itab. The row must be specified by naming values for either table_key for a table key, a free condition free_key, or an index index. The latter is possible only for index tables and when using a sorted secondary key. The output response result determines how and to where the row contents are read.

If the row to be read is not specified uniquely, the first suitable row is read. In the case of index tables, this row has the lowest row number of all suitable rows in the table index used.

System Fields

The statement READ TABLE sets the values for the system fields sy-subrc and sy-tabix.

sy-subrc

Meaning

0

Row is found. sy-tabix is set to the row number of the entry in the primary or secondary table index used. If a hash key is used, it is set to 0.

2

Like sy-subrc equals 0. Distinguishes cases that use the addition COMPARING in result.

 

The row was not found. If the entry was determined using a binary search, sy-tabix is set to the table

index of the entry before which it would be inserted using INSERT

INDEX

,

to preserve the sort

4

order. This is the case if the addition table_key or free_key was specified for a initial part of the table key of sorted keys, or if the addition BINARY SEARCH was specified explicitly. Otherwise, sy-tabix is undefined.

8

Like sy-subrc equals 4. If the entry was determined using a binary search, and the end of the table was reached, then sy-tabix is set to the number of rows + 1.

The system fields sy-tfill and sy-tleng are also filled.

Note

fields sy-tfill and sy-tleng are also filled. Note There is no implicit selection of a suitable

There is no implicit selection of a suitable key or index. The used table key or table index is always specified uniquely. The syntax check issues a warning if there is a suitable secondary table key but this table key is not used. This warning should be removed through using the key. However, in exceptional cases, it can be bypassed using a pragma.

Exceptions

Non-Catchable Exceptions

ABAP Keyword Documentation

Cause: When reading a table with READ were used. Runtime Error: DYN_KEY_DUPLICATE When reading a table with READ were used. Runtime Error: DYN_KEY_DUPLICATE

WITH [TABLE] KEY, overlapping or duplicate key specifications

Cause: When reading a table of the type SORTED , the specified key fields have to When reading a table of the type SORTED, the specified key fields have to be an initial part of the table key when BINARY SEARCH is specified. Runtime Error: ITAB_ILLEGAL_BINARY_SEARCH

Cause: No key specified. Runtime Error: ITAB_KEY_COMPONENT_MISSING No key specified. Runtime Error: ITAB_KEY_COMPONENT_MISSING

Cause: Invalid key specified when accessing a key table. Runtime Error: ITAB_KEY_ILLEGAL_COMPONENT Invalid key specified when accessing a key table. Runtime Error: ITAB_KEY_ILLEGAL_COMPONENT

Cause: Invalid key specified implicitly in the Unicode context. Runtime Error: READ_ITAB_UC_KEY_ERROR Invalid key specified implicitly in the Unicode context. Runtime Error: READ_ITAB_UC_KEY_ERROR

Cause: Invalid incompatible work area specified. Runtime Error: OBJECTS_WA_NOT_COMPATIBLE Invalid incompatible work area specified. Runtime Error: OBJECTS_WA_NOT_COMPATIBLE

Cause: Memory area violated when TABLES parameter accessed Runtime Error: ITAB_STRUC_ACCESS_VIOLATION Memory area violated when TABLES parameter accessed Runtime Error: ITAB_STRUC_ACCESS_VIOLATION

Continue READ TABLE - table_key READ TABLE - free_key READ TABLE - index READ TABLE - result Internal Tables, Key Accesses