Função OVERLAY

OVERLAY é uma função de manipulação de cadeias que manipula todos os tipos de dados de cadeia (BIT, BLOB e CHARACTER) e substitui parte de uma cadeia por uma subcadeia.

SINTAXE

OVERLAY retorna uma nova cadeia do mesmo tipo que a origem e é idêntica a source_string, exceto que uma subcadeia especificada na cadeia, começando da posição numérica especificada e do comprimento especificado, foi substituída porsource_string2. Quando o comprimento da subcadeia for zero, nada será substituído.

Por exemplo:
OVERLAY ('ABCDEFGHIJ' PLACING '1234' FROM 4 FOR 3)
retorna a cadeia 'ABC1234GHIJ'

Se qualquer parâmetro for NULL, o resultado será NULL.Se string_length não for especificado, será assumido como sendo igual a LENGTH(source_string2).

O resultado da função OVERLAY é equivalente a:
SUBSTRING(source_string FROM 1 FOR start_position -1 )
  || source_string2 ||
  SUBSTRING(source_string FROM start_position + string_length)
em que || é o operador de concatenação.
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
ak05230_