TRIM é uma função de manipulação de cadeias que manipula todos os tipos de dados de cadeia (BIT, BLOB e CHARACTER) e remove os singletons no começo e no final de uma cadeia.
>>-TRIM--(--+----------------------------------------------+----> '-+-trim_singleton-------------------+-- FROM -' | .-BOTH-----. | '-+-LEADING--+--+----------------+-' '-TRAILING-' '-trim_singleton-' >--source_string--)--------------------------------------------><
O TRIM retorna uma nova cadeia de tipo igual a source_string, da qual foram removidos os singletons do começo , do fim ou de ambos os lados. O termo singleton refere-se a uma única parte (BIT, BYTE ou CHARACTER) dentro de uma cadeia desse tipo.
O singleton pode conter uma lista de diversos caracteres a serem cortados da sequência de origem.
Caractere | ' ' (espaço) |
---|---|
BLOB | X'00' |
Bit | B'0' |
Se qualquer parâmetro for NULL, o resultado será NULL.
Geralmente, não é necessário dividir espaços em banco finais de cadeias de caracteres antes da comparação, porque as regras de comparação de cadeias de caracteres significam que os espaços em branco final não são significativos.
TRIM(TRAILING 'b' FROM 'aaabBb')
retorna 'aaabB'. TRIM(' a ')
retorna 'a'. TRIM(LEADING FROM ' a ')
retorna 'a '. TRIM('b' FROM 'bbbaaabbb')
retorna 'aaa'.DECLARE input1 CHARACTER 'testmgktest';
SET OutputRoot.XMLNSC.Top.Out1 = TRIM( 'ste' FROM input1);
O código precedente produz a mensagem de saída:<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);
O código precedente produz a mensagem de saída:<Top><Out2>smith</Out2></Top>