Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  Program Flow →  Expressions and Functions for Logical Expressions →  log_exp - Logical Expressions →  log_exp - Predicates →  log_exp - IS 

log_exp - IS BOUND

Other versions: 7.31 | 7.40 | 7.54

Syntax


... ref IS [NOT] BOUND ...

Effect

This logical expression checks whether a reference variable contains a valid reference. For ref, you must specify a data object defined with addition REF TO or a functional method, whose return value is typed with REF TO.

A data reference is valid if it can be dereferenced. An object reference is valid if it points to an object.

When using addition NOT, the expression is true if the reference variable does not contain a valid reference.


Note

A non-initial reference variable that contains a heap reference is generally always valid (since it keeps an object alive). Only heap references that point to rows from internal tables can become invalid when rows are deleted. A data reference variable that contains a stack reference, on the other hand, can become invalid even if the reference data object is removed from the stack.


Example

The logical expression in the IF statement is false. The data reference dref contains a reference to a deleted table row.

DATA: dref TYPE REF TO data,
      itab TYPE TABLE OF ...

FIELD-SYMBOLS <fs> TYPE ANY.

READ TABLE itab REFERENCE INTO dref
           WITH ...

...

CLEAR itab.

...

IF dref IS BOUND.
  ASSIGN dref->* TO <fs>.
ENDIF.