STUFF

文字列内の部分文字列を置換する文字列関数です。

Synopsis

STUFF(string,start,length,substring)

string	部分文字列置換の置換対象となる文字列式。
start	正の整数として指定される置換の開始地点。string の最初から文字数がカウントされ、カウントは 1 を基準とします。許可される値は 0 ～ string の長さまでです。文字を追加するには、0 の start および 0 の length を指定します。空の文字列または数値以外の値は 0 として処理されます。
length	正の整数として指定される、置換する文字数。文字を挿入するには、0 の length を指定します。start の後のすべての文字を置き換えるには、既存の文字数より大きい length を指定します。空の文字列または数値以外の値は 0 として処理されます。
substring	開始地点と長さで識別される部分文字列を置き換えるのに使用する文字列式。置き換える部分文字列よりも長くするか短くすることができます。空の文字列でもかまいません。

STUFF は、部分文字列を別の部分文字列と置き換えます。位置と長さにより置き換える部分文字列を特定し、それを substring と置き換えます。

この関数には Transact-SQL 実装との互換性があります。

置換 substring は、元の値よりも長いか短い場合があります。元の値を削除するために、substring を空文字列 (") にすることができます。

start の値は、string の現在の長さ以内である必要があります。0 の start を指定すると、string の先頭に substring を追加できます。空の文字列または数値以外の値は 0 として処理されます。

start、length、または substring 引数に NULL を指定すると、NULL が返されます。

REPLACE および STUFF の両方とも、部分文字列の置換を実行します。REPLACE は、データ値によって部分文字列を検索します。STUFF は、文字列の位置と長さによって部分文字列を検索します。

部分文字列を検索する関数のリストは、このドキュメントの "概念" セクションにある "文字列操作" を参照してください。

以下の例は、KING を KONG に変える、単一文字の置換を示しています。

SELECT STUFF('KING',2,1,'O')

以下の例は、8 文字の部分文字列 (Kentucky) をこれより長い 12 文字の部分文字列、およびこれより短い 2 文字の部分文字列で置き換えます。

SELECT STUFF('In my old Kentucky home',11,8,'Rhode Island'),
       STUFF('In my old Kentucky home',11,8,'KY')

以下の例は、部分文字列を挿入します。

SELECT STUFF('In my old Kentucky home',19,0,' (KY)')

以下の例は、部分文字列を文字列の最初に追加します。

SELECT STUFF('In my old Kentucky home',0,0,'The sun shines bright ')

以下の例は、空の文字列で置き換えることにより、8 文字の部分文字列を削除します。

SELECT STUFF('In my old Kentucky home',11,8,'')