WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Função TRIM

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.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-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.

Se trim_singleton não for especificado, será assumido um singleton padrão. O singleton padrão depende do tipo de dados de source_string :
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.

Os exemplos a seguir ilustram o comportamento da função TRIM:
TRIM(TRAILING 'b' FROM 'aaabBb')
retorna 'aaabB'.
TRIM('  a  ')
retorna 'a'.
TRIM(LEADING FROM '  a  ')
retorna 'a '.
TRIM('b' FROM 'bbbaaabbb')
retorna 'aaa'.
Um exemplo de como usar um singleton de diversos caracteres é:
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>
Um exemplo de como usar um singleton de diversos caracteres para remover caracteres de espaço em branco à esquerda ou à direita é:
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>
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:55


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ak05270_