TRIM (Abschneiden) ist eine Funktion zur Bearbeitung von Zeichenfolgen, die alle Datentypen (BIT, BLOB und CHARACTER) verarbeitet und abschließende und führende Singletons von einer Zeichenfolge entfernt.
>>-TRIM--(--+---------------------------------------------------+--> '-+-Singletonausschnitt-------------------+-- FROM -' | .-BOTH-----. | '-+-LEADING--+--+---------------------+-' '-TRAILING-' '-Singletonausschnitt-' >--Quellenzeichenfolge--)--------------------------------------><
TRIM gibt eine neue Zeichenfolge desselben Typs wie die Quellenzeichenfolge zurück, in der die führenden, abschließenden oder beide, sowohl die führenden als auch die abschließenden, Singletons entfernt wurden. Der BegriffSingleton bezieht sich auf einen einzelnen Teil (BIT, BYTE oder CHARACTER) innerhalb einer Zeichenfolge dieses Typs.
Das Singleton kann eine Liste aus mehreren Zeichen enthalten, die aus der Quellenzeichenfolge ausgeschnitten sind.
Zeichen | ' ' (Leerzeichen) |
---|---|
BLOB | X'00' |
Bit | B'0' |
Falls einer der Parameter NULL ist, ist auch das Ergebnis NULL.
Oft ist es nicht notwendig, abschließende Leerzeichen vor dem Vergleich von Zeichenfolgen abzuschneiden, da die Regeln des Zeichenfolgevergleichs besagen, dass abschließende Leerzeichen nicht von Bedeutung sind.
TRIM(TRAILING 'b' FROM 'aaabBb')
gibt 'aaabB' zurück. TRIM(' a ')
gibt 'a' zurück. TRIM(LEADING FROM ' a ')
gibt 'a ' zurück. TRIM('b' FROM 'bbbaaabbb')
gibt 'aaa' zurück.DECLARE input1 CHARACTER 'testmgktest';
SET OutputRoot.XMLNSC.Top.Out1 = TRIM( 'ste' FROM input1);
Der führende Code erstellt die Ausgabenachricht:<Top><Out1>mgk</Out1></Top>
DECLARE whiteSpace CONSTANT CHARACTER CAST( X'090D0A20' AS CHAR CCSID 1208);
/* tab, cr, lf, space */
DECLARE input2 CHARACTER 'smith';
SET input2 = whiteSpace || input2 || whiteSpace;
SET OutputRoot.XMLNSC.Top.Out2 = TRIM( whiteSpace FROM input2);
Der führende Code erstellt die Ausgabenachricht:<Top><Out2>smith</Out2></Top>