Función OVERLAY

OVERLAY es una función de manejo de series que maneja todos los tipos de datos de serie (BIT, BLOB y CHARACTER), y sustituye parte de una serie con una subserie.

Sintaxis

OVERLAY devuelve una serie nueva del mismo tipo que la de origen e idéntica a serie_origen, salvo que una subserie dada en la serie, empezando por la posición numérica especificada y de la longitud suministrada, se ha sustituido por serie_origen2. Cuando la longitud de la subserie es cero, no se realiza ninguna sustitución.

Por ejemplo:
OVERLAY ('ABCDEFGHIJ' PLACING '1234' FROM 4 FOR 3)
devuelve la serie 'ABC1234GHIJ'

Si cualquier parámetro es NULL, el resultado es NULL. Si no se especifica longitud_serie, se supone que es igual a LENGTH(serie_origen2).

El resultado de la función OVERLAY es equivalente a:
SUBSTRING(serie_origen FROM 1 FOR
posición_inicio -1 )
  || serie_origen2 ||
  SUBSTRING(serie_origen FROM posición_inicio +
longitud_serie)
donde || es el operador de concatenación.

Conceptos relacionados
ESQL

Tareas relacionadas
Desarrollo de ESQL

Referencia relacionada
Preferencia de sintaxis
Funciones de manejo de series ESQL