ABAP SyntaxDESCRIBE DISTANCE BETWEEN dobj1 AND dobj2 INTO
dst
IN {BYTE|CHARACTER} MODE.
What does it do? This statement determines the distance between the start
positions of the data objects dobj1 and dobj2 .
The return value has the type i . The following can be specified
for dst :
An existing variable to which the return value can be converted.
An inline declaration DATA(var) , where
a variable of type i is declared.
In the case of deeper data types, the
referenced data object is not relevant but the position of the internal
reference (for strings and internal tables) or the reference variables
instead. It is not important in which order dobj1 and dobj2
are specified.
The addition MODE must be specified in
Unicode programs . The variant with
the addition IN BYTE MODE determines the distance in bytes. The
variant with the addition IN CHARACTER MODE converts the distance
into characters that can be stored in this length according to the
current character format. In
non-Unicode programs , the addition MODE can be omitted. In
this case, the addition IN BYTE MODE is used implicitly. When
this addition is used in IN CHARACTER MODE and the determined
distance cannot be converted into a number of characters, a
non-handleable exception is raised.
Latest notes: The distance between data objects should only be
determined within the same structure and only the structure's components
should be used, since this is the only way to guarantee that they follow
each other immediately in the memory. Note that the
alignment gaps are counted as well.
Therefore, use the addition in IN BYTE MODE to avoid a
non-handleable exception.
With respect to DESCRIBE DISTANCE , every substructure declared
as a boxed component is an
independent structure. The distance between components which are not in
the same boxed component is undefined.
Example ABAP Coding See Determining Data
Object Distances .
Runtime Exceptions Non-catchable Exceptions
Reason for error: Distance cannot be converted into characters.
Runtime error: UC_NO_CHAR_NUMBER
Documentation extract taken from SAP system, � Copyright SAP AG. All rights reserved