Função REPLACE

REPLACE é uma função de manipulação de cadeias que manipula todos os tipos de dados de cadeia (BIT, BLOB e CHARACTER) e substitui partes de uma cadeia por subcadeias fornecidas.

SINTAXE

REPLACE retorna uma cadeia que consiste na cadeia de origem com cada ocorrência da cadeia de procura substituída pela cadeia de substituição. As cadeias de parâmetro podem ser dos tipos de dados CHARACTER, BLOB ou BIT, mas as três precisam ser do mesmo tipo.

Se qualquer parâmetro for NULL, o resultado será NULL.

O processo de procura é uma passagem simples a partir da esquerda e desconsidera os caracteres que já foram correspondidos.

Se você não especificar a expressão da cadeia de substituição, a cadeia de substituição utilizará o valor padrão de uma cadeia vazia e o comportamento da função será a exclusão de todas as ocorrências da cadeia de procura do resultado.

Os exemplos a seguir fornecem os resultados mostrados:
      REPLACE('ABCDABCDABCDA', 'A', 'AA')
      -- RESULT = AABCDAABCDAABCDAA
O exemplo acima mostra que a substituição possui uma direção única. Cada ocorrência de A é substituída por AA, mas estes não são expandidos novamente.
      REPLACE('AAAABCDEFGHAAAABCDEFGH', 'AA', 'A')  
      -- RESULT = AABCDEFGHAABCDEFGH
Este exemplo mostra que depois que os caracteres são correspondidos, eles não são mais considerados. Cada ocorrência de AA é substituída por A. Os pares AA resultantes não são correspondidos.
     REPLACE('AAAAABCDEFGHAAAABCDEFGH', 'AA', 'XYZ')
      -- RESULT = XYZXYZABCDEFGHXYZXYZBCDEFGH
Este último exemplo mostra que a correspondência ocorre do lado esquerdo. Os quatro primeiros As são correspondidos como dois pares e substituídos. O quinto A não é correspondido.
Conceitos relacionados
Visão Geral do ESQL
Tarefas relacionadas
Desenvolvendo ESQL
Referências relacionadas
Diagramas de Sintaxe: Tipos Disponíveis
Funções de Manipulação de Cadeia ESQL
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:44

ak05241_