OVERLAY

source-string

ソース・ストリングを指定する式。 source-string には、任意の組み込み数値、ストリング、または日時式を指定できます。 これは、挿入ストリング と互換性のあるものでなければなりません。 データ・タイプの互換性についての詳細は、割り当ておよび比較を参照してください。 数値引数または日時引数は、 関数を評価する前に、現行サーバーでデフォルト SBCS CCSID である CCSID を使用して VARCHAR にキャストされます。数値または日時からさまざまな文字ストリングへの変換について詳しくは、VARCHAR を参照してください。ストリングの実際の長さはゼロより大きくなくてはなりません。

OVERLAY 関数は、引数の順序が異なり、length がオプションである点を除けば、INSERT 関数と同一です。

insert-string

ソース・ストリング に挿入する、 開始桁 で示される位置から開始するストリングを指定する式。 insert-string には、任意の組み込み数値、ストリング、または日時式を指定できます。 これは、ソース・ストリング と互換性のあるものでなければなりません。 データ・タイプの互換性についての詳細は、割り当ておよび比較を参照してください。 数値引数または日時引数は、 関数を評価する前に、現行サーバーでデフォルト SBCS CCSID である CCSID を使用して VARCHAR にキャストされます。数値または日時からさまざまな文字ストリングへの変換について詳しくは、VARCHAR を参照してください。

start

任意の組み込み数値、文字ストリング、 またはグラフィック・ストリングのデータ・タイプの値を戻す式。 値がタイプ INTEGER でない場合、その値は関数を評価する前に暗黙的に INTEGER にキャストされます。整数は、文字の削除と別のストリングの挿入を開始するソース・ストリング 内の開始文字を指定します。 整数の値は、1 からソース・ストリング の長さに 1 を加えた数の範囲でなければなりません。

length

任意の組み込み数値、文字ストリング、 またはグラフィック・ストリングのデータ・タイプの値を戻す式。 値がタイプ INTEGER でない場合、その値は関数を評価する前に暗黙的に INTEGER にキャストされます。この整数は、ソース・ストリング から削除される、開始桁 で示される文字位置から始まる文字数を指定します。 整数の値は、0 からソース・ストリング の長さまでの範囲でなければなりません。

関数の結果のデータ・タイプは、1 番目と 2 番目の引数のデータ・タイプによって決まります。 結果のデータ・タイプは、結果は常に可変長ストリングであることを除けば、 2 つの引数を連結した場合と同じです。 詳しくは、ストリングを結合する演算に適用される変換規則を参照してください。

結果の長さ属性は、引数によって次のように異なります。

• 開始桁 と長さ が定数の場合、結果の長さ属性は次のとおりです。

  L1 - MIN((L1-V2 + 1), V3) + L4

  ここで、

  L1 はソース・ストリングの長さ属性
  V2 は次のようにソース・ストリングのエンコード・スキーマに依存します。
  - ソース・ストリングが UTF-8 の場合は値 MIN(L1+1,start*3)
  - ソース・ストリングが混合データの場合は値 MIN(L1+1,(start-1)*2.5+4)
  上記以外の場合は値 start
  V3 は長さの値
  L4 は挿入ストリングの長さ属性
   

• それ以外の場合は、結果の長さ属性は、ソース・ストリング の長さ属性と 挿入ストリング の長さ属性を足したものになります。

結果の長さ属性が結果のデータ・タイプの最大長を超える場合は、エラーが戻されます。

結果の実際の長さは、次のとおりです。

結果ストリングの実際の長さが結果のデータ・タイプの最大長を超える場合は、エラーが戻されます。

引数のいずれかが NULL になる可能性がある場合、結果も NULL になる可能性があります。 引数のいずれかが NULL の場合、その結果は NULL 値です。

結果の CCSID は、ソース・ストリング と挿入ストリング の CCSID によって決定されます。 結果 CCSID は、2 つの引数を連結した場合と同じです。 詳しくは、ストリングを結合する演算に適用される変換規則を参照してください。