GET REFERENCE

Basic form 11

GET REFERENCE OF f INTO dref.

Effect

Creates a reference dref to a data object (field) f.

The reference to f is written to the reference variable ref. dref can be any reference variable with type REF TO DATA or REF TO type. For typed reference variables, the data type of f must be compatible with the type of the reference variables. If the referencing is successful, the logical expression dref IS BOUND is true.

Example

DATA: dref    TYPE REF TO DATA,
      booking TYPE sbook.

FIELD-SYMBOLS: <fs> TYPE ANY.

GET REFERENCE OF booking INTO dref.
ASSIGN dref->* TO <fs>.

This example creates a reference dref to the data object booking. The data object is then assigned to the field symbol <fs> using the dereferencing operator ->*. Since dref is generic, this is the only type of dereferencing.

Exceptions

Non-Catchable Exceptions

• Cause: The data object after INTO is not a reference variable.
  Runtime Error: GET_REF_REFERENCE_EXPECTED
  
• Cause: GET REFERENCE is not allowed for substrings.
  Runtime Error: GET_REF_SUBSTRING_NOT_ALLOWED
  
  
  

Related

CREATE DATA, FIELD-SYMBOLS, ASSIGN

Notes

References to local variables are invalid once you leave the environment of the local variable.

Non-Catchable Exceptions