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')             ==> AABCDAABCDAABCDAA
            REPLACE('AAAABCDEFGHAAAABCDEFGH', 'AA', 'XYZ')  ==>
XYZXYZBCDEFGHXYZXYZBCDEFGH
            REPLACE('AAAAABCDEFGHAAAABCDEFGH', 'AA', 'XYZ') ==>
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
ESQL

Tarefas relacionadas
Desenvolvendo ESQL

Referências relacionadas
Preferência de Sintaxe
Funções de Manipulação de Cadeia ESQL