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. Os exemplos a seguir fornecem os resultados mostrados:
      REPLACE('ABCDABCDABCDA', 'A', 'AA')
      -- RESULT = AABCDAABCDAABCDAA
      REPLACE('AAAABCDEFGHAAAABCDEFGH', 'AA', 'XYZ')
      -- RESULT = XYZXYZBCDEFGHXYZXYZBCDEFGH
      REPLACE('AAAAABCDEFGHAAAABCDEFGH', 'AA', 'XYZ')
      -- RESULT = XYZXYZABCDEFGHXYZXYZBCDEFGH

O primeiro exemplo 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.

O segundo exemplo mostra que os caracteres que foram correspondidos uma vez não são mais considerados. O primeiro par AA é correspondido, substituído e desconsiderado. O segundo e o terceiro As não são correspondidos.

O terceiro 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.

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

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
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ak05241_