REPLACE (SSIS 式)

式に含まれている文字列を別の文字列または空の文字列で置き換えた文字式を返します。

注意

REPLACE 関数では、長い文字列が頻繁に使用されます。 切り捨ての結果を効率よく処理できる場合もあれば、結果により警告またはエラーが発生する場合もあります。 詳細については、「構文 (SSIS)」を参照してください。

構文

REPLACE(character_expression,searchstring,replacementstring)

引数

  • character_expression
    検索対象となる有効な文字式です。

  • searchstring
    関数により検索される有効な文字式です。

  • replacementstring
    置換後の式となる有効な文字式です。

戻り値の型

DT_WSTR

説明

searchstring の長さは 0 にできません。

replacementstring の長さは 0 にできます。

searchstring および replacementstring 引数には、変数および列を使用できます。

REPLACE は、DT_WSTR データ型でのみ機能します。 character_expression1, character_expression2, および character_expression3 引数が DT_STR データ型の文字列リテラルまたはデータ列である場合は、REPLACE による演算の実行前に、暗黙的に DT_WSTR データ型にキャストされます。 その他のデータ型は、明示的に DT_WSTR データ型にキャストされる必要があります。 詳細については、「Cast (SSIS 式)」を参照してください。

いずれかの引数が NULL の場合、REPLACE は NULL を返します。

式の例

この例では、文字列リテラルを使用します。 返される結果は "All Terrain Bike" です。

REPLACE("Mountain Bike", "Mountain","All Terrain")

この例では、Product 列から文字列 "Bike" を削除します。

REPLACE(Product, "Bike","")

この例では、DaysToManufacture 列の値を置換します。 DaysToManufacture 列は整数データ型で、式の内部で DT_WSTR データ型にキャストされます。

REPLACE((DT_WSTR,8)DaysToManufacture,"6","5")

関連項目

参照

SUBSTRING (SSIS 式)

その他の技術情報

関数 (SSIS 式)