OVERLAY-Funktion

OVERLAY (Überschreiben) ist eine Funktion zur Bearbeitung von Zeichenfolgen, die alle Typen von Zeichenfolgedaten (BIT, BLOB und CHARACTER) verarbeitet und einen Teil einer Zeichenfolge durch eine Unterzeichenfolge ersetzt.

SYNTAX

OVERLAY gibt eine neue Zeichenfolge desselben Typs wie die Quelle zurück und ist mit der Quellenzeichenfolge identisch, außer wenn eine gegebene, in der Zeichenfolge enthaltene Unterzeichenfolge, die von der angegebenen numerischen Position startet und die angegebene Länge hat, durch die Quellenzeichenfolge2 ersetzt wurde. Wenn die Länge der Unterzeichenfolge null ist, wird nichts ersetzt.

Beispiel:
OVERLAY ('ABCDEFGHIJ' PLACING '1234' FROM 4 FOR 3)
gibt die Zeichenfolge 'ABC1234GHIJ' zurück.

Falls ein Parameter NULL ist, ist das Ergebnis NULL. Falls die Zeichenfolgelänge nicht angegeben ist, so wird vorausgesetzt, dass sie gleich LENGTH(Quellenzeichenfolge2) ist.

Das Ergebnis der OVERLAY-Funktion ist äquivalent zu:
SUBSTRING(Quellenzeichenfolge FROM 1 FOR Ausgangsposition -1 )
  || Quellenzeichenfolge2 ||
  SUBSTRING(Quellenzeichenfolge FROM Anfangsposition + Zeichenfolgelänge)
Hierbei ist || der Verknüpfungsoperator.
Zugehörige Konzepte
Übersicht zu ESQL
Zugehörige Tasks
ESQL erstellen
Zugehörige Verweise
Syntaxdiagramme: verfügbare Typen
ESQL-Funktionen zur Bearbeitung von Zeichenfolgen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
ak05230_