Skip to content

ABAP Keyword Documentation →  ABAP − Reference →  program editing →  Dynamic Program Editing →  text element 

READ TEXTPOOL

Quick Reference

Other versions: 7.31 | 7.40 | 7.54

Syntax


READ TEXTPOOL prog INTO itab LANGUAGE lang. 

Effect

This statement reads the text elements of the text pool of the language specified in lang and the program specified in prog from the repository and places them into the internal table itab. The previous content of itab is deleted. If the text elements cannot be read, the content of itab remains unchanged. The active text elements of the program are read by default.

prog expects a flat character-like data object, which contains the name of the program of the text elements to be read; the name is not case-sensitive. The internal table itab can be in any table category and its row type must correspond to the TEXTPOOL structure in ABAP Dictionary.

lang expects a character-like flat data object. This must contain a language key with a maximum length of one character, and this value must be contained in the column SPRAS of the database table T002. If lang contains a space, the behavior is undefined.

After a successful read, itab contains, in the ENTRY column, the texts of the text symbols, the selection texts, the list headers, and the title from the program attributes. Every text element that exists for the specified language occupies one row of the internal table and is identified uniquely by the columns ID and KEY. The column LENGTH contains the length of the text element. The table below shows the possible values of the columns ID and KEY and their meaning:

ID KEY ENTRY
H 001 through 004 List Header Column Headers
I ID of a text symbol Text of the text symbol
R - Program title
S Name of a parameter or selection criterion Selection text
T - List Header Title bar

System Fields

sy-subrc Meaning
0 At least one text element was read.
4 The program specified in prog or the language specified in lang does not exist or there is no text pool in the specified language.


Notes

  • The table of program types indicates which program types support text pools. sy-subrc is always set to 4, for programs without text pools.
  • When handling global classes and function groups, note that the name of the wrapper program must be specified in the repository and not the name of the class or function group. The way these names are created is documented in the statements CLASS-POOL and FUNCTION-POOL.
  • For selection texts that are not taken from ABAP Dictionary, the actual text in ENTRY is preceded by eight blanks.
  • Selection texts taken from ABAP Dictionary are not stored in the text pool and cannot be read with READ TEXTPOOL. They contain a "D" in the first position of ENTRY. To read the selection texts stored in ABAP Dictionary, use the function module RS_TEXTPOOL_READ.

Example

See INSERT TEXTPOOL

Continue

READ TEXTPOOL - Internal Addition