TRIM( ) Gleiche Zeichen am Anfang oder Ende entfernen

Anwendungsgebiet: String-Funktionen

Die Funktion TRIM( ) entfernt gleiche Zeichen am Anfang oder Ende oder an beiden Seiten eines Strings.

Format

TRIM( )

STRING = string_ausdruck

,SIDE = *BOTH / *LEFT / *RIGHT

,TRIM-BYTE = C' ' / zeichen

Ergebnistyp

STRING

Eingabeparameter

STRING = string_ausdruck
Bezeichnet einen Ausdruck vom Typ STRING, der bearbeitet werden soll.

SIDE = *BOTH / *LEFT / *RIGHT
Das im Parameter TRIM-BYTE angegebene Zeichen wird am Anfang des Strings (*LEFT), an seinem Ende (*RIGHT) oder an beiden Seiten (*BOTH) so oft entfernt, bis ein anderes Zeichen auftritt. Enthält der String kein anderes Zeichen, ist das Funktionsergebnis der Leerstring.

TRIM-BYTE = C' ' / zeichen
Bezeichnet das Zeichen (als C-Literal), das entfernt werden soll. Voreinstellung: Blank (Leerzeichen). Blank wird auch angenommen, wenn ein Nullstring (C'') eingegeben wird.

Ergebnis

String in gekürzter Form

Fehlermeldung

Keine Fehlermeldungen

Beispiel

/A = '  ABC   '
/B = '  ABC000'
/A = TRIM(STRING=A)
/B = TRIM(STRING=B,SIDE=*LEFT,TRIM-BYTE=' ')
/B = TRIM(STRING=B,SIDE=*RIGHT,TRIM-BYTE='0')
/SHOW-VARIABLE VALUE=*C-LITERAL 
A = 'ABC'
B = 'ABC'