Ansicht
Dokumentation

ABAPCONVERT_TEXT - CONVERT TEXT

rdisp/max_wprun_time - Maximum work process run time   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

CONVERT TEXT

Kurzreferenz

CONVERT TEXT text INTO SORTABLE CODE hex.

Wirkung

Der Inhalt des Operanden text wird in eine sortierbare Bytefolge konvertiert und das Ergebnis dem Zielfeld hex zugewiesen, wobei das Datenobjekt text selbst unverändert bleibt.

Der Operand text muss vom Typ c oder string sein. text ist eine zeichenartige Ausdrucksposition. Für hex kann angegeben werden:

• Eine vorhandene byteartige Variable.

• Eine Inline-Deklaration DATA(var) oder FINAL(var), wobei eine Variable vom Typ xstring deklariert wird.

Der Inhalt von text muss gültige Zeichen enthalten. Die sortierbare Bytefolge ist plattformabhängig so definiert, dass ein Größenvergleich oder eine Standardsortierung mehrerer solcher Felder zu einer Reihenfolge führt, in der die Ausgangsfelder text nach dem in der aktuellen Textumgebung definierten Locale sortiert sind. Die Textumgebung wird beim Öffnen einer internen Sitzung oder über die Anweisung SET LOCALE gesetzt.

Wenn das Zielfeld hex vom Typ x ist und seine Länge nicht für die Bytefolge ausreicht, kommt es zu einer unbehandelbaren Ausnahme. Wenn die Länge größer als die der Bytefolge ist, wird rechts mit hexadezimal 0 aufgefüllt. Die für alle Plattformen ausreichende Länge berechnet sich aus 24-mal die Länge von text plus 24, kann aber für einzelne Plattformen deutlich geringer sein. Wenn hex vom Typ xstring ist, passt sich seine Länge automatisch an.

Hinweis

Die Anweisung CONVERT TEXT ist im Wesentlichen dazu vorgesehen, in internen Tabellen eine Indexspalte zu füllen, nach der die Zeilen der Tabelle gemäß einem Locale sortiert werden können. Da interne Tabellen durch den Zusatz AS TEXT der Anweisung SORT auch direkt gemäß einem Locale sortiert werden können, ist CONVERT TEXT besonders für die nachfolgenden Anforderungen geeignet:

• Eine interne Tabelle soll gemäß einem Locale sortiert und dann mit der Anweisung READ TABLE oder einem Tabellenausdruck binär durchsucht werden.

• Eine interne Tabelle soll mehrfach nach einem Locale sortiert werden. Die Verwendung einer sortierbaren Bytefolge ist dann performanter als der Zusatz AS TEXT.

• Indizes für DDIC-Datenbanktabellen sollen gemäß einem Locale aufgebaut werden.

• Es sollen textuelle Vergleiche zwischen zeichenartigen Datenobjekten vorgenommen werden.
  
  

Die Zeichen "a" und "Z" werden direkt und nach der Konvertierung mit CONVERT TEXT verglichen. Während "Z" beim direkten Vergleich für die meisten Codepages vor "a" liegt, liefert der Vergleich der konvertierten Werte die erwartete textuelle Reihenfolge. Siehe auch das ausführbare Beispiel zu SORT für interne Tabellen.

Die Zeichen "a" und "Z" werden direkt und nach der Konvertierung mit CONVERT TEXT verglichen. Während "Z" beim direkten Vergleich für die meisten Codepages vor "a" liegt, liefert der Vergleich der konvertierten Werte die erwartete textuelle Reihenfolge. Siehe auch das ausführbare Beispiel zu SORT für interne Tabellen.

Ausnahmen

Unbehandelbare Ausnahmen

• Ursache: Einer der Operanden hat einen unzulässigen Datentyp.
  Laufzeitfehler: CONVERT_TEXT_BAD_OP

• Ursache: Das Quellfeld hat einen unzulässigen Inhalt.
  Laufzeitfehler: CONVERT_TEXT_BAD_SRC

• Ursache: Das Zielfeld ist zu klein.
  Laufzeitfehler: CONVERT_TEXT_DEST_TOO_SHORT
  
  

Addresses (Business Address Services)   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 5691 Date: 20240426 Time: 132210     sap01-206 ( 117 ms )