SAP NetWeaver AS ABAP Release 750, ©Copyright 2016 SAP AG. Alle Rechte vorbehalten.

ABAP - Schlüsselwortdokumentation →  ABAP - Referenz →  Interne Daten verarbeiten →  Zeichen- und Bytekettenverarbeitung →  Ausdrücke und Funktionen für die Zeichenkettenverarbeitung →  Zeichenkettenfunktionen →  Verarbeitungsfunktionen für zeichenartige Argumente → 

condense - Verdichtungsfunktion

Syntax

... condense( [val =] text [del = del] [from = from] [to = to] ) ...

Wirkung

Diese Funktion gibt den wie folgt verdichteten Inhalt von text zurück:

• Aus der Zeichenkette aus text werden alle führenden und schließenden Zeichen entfernt, die in del enthalten sind. Wenn del ein leerer String ist, werden keine Zeichen entfernt.

• In der Zeichenkette aus text werden alle Unterfolgen, die aus in from angegebenen Zeichen zusammengesetzt sind, durch das erste Zeichen der in to angegebenen Zeichenfolge ersetzt. Wenn from ein leerer String ist, werden keine Zeichen ersetzt. Wenn to ein leerer String ist, werden die in from angegebenen Zeichen aus der Zeichenkette entfernt.

Die Standardwerte für del, from und to sind jeweils ein Leerzeichen. Wenn weder del, noch from, noch to angegeben sind, kann auch val = weggelassen werden.

del, from und to sind zeichenartige Ausdruckspositionen. Wenn diese eine feste Länge haben, werden schließende Leerzeichen nicht berücksichtigt.

Der Rückgabewert ist vom Typ string.

Hinweise

• Mit den Standardwerten für del, from und to wirkt die Funktion condense wie die Anweisung CONDENSE ohne den Zusatz NO-GAPS.

• Durch die Angabe eines leeren Strings für from lassen sich die führenden und schließenden Leerzeichen entfernen, ohne die sonstige Zeichenkette zu beeinflussen.

Beispiel

Die Rückgabewerte der folgenden Funktionsaufrufe sind "abc_def", "abc___def" und "abcXdef" (wobei "_" für ein Leerzeichen steht).

result = condense( val = `  abc   def  ` ).

result = condense( val = `  abc   def  ` from = `` ).

result = condense( val = `XXabcXXXdefXX`
         del = 'X' from = 'X' to = 'X' ).

Beispiel

Der Rückgabewert des folgenden Funktionsaufrufs ist "Rock'n'Roll".

result = condense( val = `  Rock'xxx'Roller`
                   del = `re `
                   from = `x` to = `n`  ).