Ansicht
Dokumentation

ABAPDESCRIBE_DISTANCE - DESCRIBE DISTANCE

ABAPDESCRIBE_DISTANCE - DESCRIBE DISTANCE

PERFORM Short Reference   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

DESCRIBE DISTANCE

Kurzreferenz



DESCRIBE DISTANCE BETWEEN dobj1 AND dobj2 INTO dst
                          IN ${BYTE$|CHARACTER$} MODE.

Wirkung

Diese Anweisung bestimmt den Abstand zwischen den Anfangspositionen der Datenobjekte dobj1 und dobj2.

Der Rückgabewert ist vom Typ i. Für dst kann angegeben werden:

  • Eine vorhandene Variable, in die der Rückgabewert konvertiert werden kann.

Die Reihenfolge, in der dobj1 und dobj2 angegeben sind, spielt keine Rolle.

Die Variante mit dem Zusatz IN BYTE MODE stellt den Abstand in Bytes fest. Die Variante mit dem Zusatz IN CHARACTER MODE rechnet den Abstand in die Anzahl von Zeichen um, die gemäß der aktuellen Zeichendarstellung in dieser Länge abgespeichert sein können. Falls bei Verwendung des Zusatzes in IN CHARACTER MODE der festgestellte Abstand nicht in eine Anzahl von Zeichen umgerechnet werden kann, kommt es zu einer unbehandelbaren Ausnahme.

Bei tiefen Datentypen wird dabei nicht das referenzierte Datenobjekt, sondern die Position der internen Referenz (bei Strings und internen Tabellen) bzw. der Referenzvariablen betrachtet.

Hinweise

  • Die Ermittlung des Abstands zwischen Datenobjekten sollte nur innerhalb einer Struktur auf deren Komponenten angewendet werden, da nur bei diesen garantiert ist, dass sie im Speicher immer direkt aufeinander folgen. Dabei ist zu beachten, dass Ausrichtungslücken mitgezählt werden, weshalb zur Vermeidung einer unbehandelbaren Ausnahme der Zusatz in IN BYTE MODE verwendet werden sollte.
  • Bezüglich DESCRIBE DISTANCE ist jede als Boxed Component deklarierte Unterstruktur eine unabhängige Struktur. Der Abstand zwischen Komponenten, die nicht in der gleichen Boxed Component liegen, ist undefiniert.

Beispiel

Die Ergebnisse der beiden Anweisungen in einem Unicode-System sind 5 und 10.

Abstand von Datenobjekten ermitteln

Ausnahmen

Unbehandelbare Ausnahmen

  • Ursache: Abstand kann nicht in Zeichen umgerechnet werden
    Laufzeitfehler: UC_NO_CHAR_NUMBER





Vendor Master (General Section)   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3767 Date: 20240329 Time: 081129     sap01-206 ( 58 ms )