Ansicht
Dokumentation
ABAPDESCRIBE_DISTANCE - DESCRIBE DISTANCE
PERFORM Short Reference rdisp/max_wprun_time - Maximum work process run timeDiese Dokumentation steht unter dem Copyright der SAP AG.
DESCRIBE DISTANCE
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.
- Inline-Deklaration DATA(var) oder FINAL(var), wobei eine Variable vom Typ i deklariert wird.
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 )