オーバーレイ

説明

OVERLAY関数は、文字列内の指定された位置と長さの部分文字列を置換するために使用されます。指定された位置から開始して、指定された長さの文字を新しい文字列で置換します。この関数はマルチバイト安全です。

この関数はMySQLのINSERT functionと一貫した動作をします。

エイリアス

• INSERT

構文

OVERLAY(<str>, <pos>, <len>, <newstr>)

パラメータ

パラメータ	説明
<str>	変更対象の元の文字列。型: VARCHAR
<pos>	置換開始位置（1ベース）。型: INT
<len>	置換する文字数。型: INT
<newstr>	置換に使用する新しい文字列。型: VARCHAR

戻り値

VARCHAR型を返し、置換後の新しい文字列です。

特殊なケース:

• いずれかのパラメータがNULLの場合、NULLを返します
• <pos>が1未満または文字列長を超える場合、置換は行われず元の文字列を返します
• <len>が0未満または残りの長さを超える場合、<pos>から文字列の末尾まで置換します

例

1. 基本的な使用法: 中央部分の置換

SELECT overlay('Quadratic', 3, 4, 'What');

+------------------------------------+
| overlay('Quadratic', 3, 4, 'What') |
+------------------------------------+
| QuWhattic                          |
+------------------------------------+

2. 負の長さ: 末尾まで置換

SELECT overlay('Quadratic', 2, -1, 'Hi');

+-----------------------------------+
| overlay('Quadratic', 2, -1, 'Hi') |
+-----------------------------------+
| QHi                               |
+-----------------------------------+

3. 範囲外の位置: 置換なし

SELECT overlay('Hello', 10, 2, 'X');

+-------------------------------+
| overlay('Hello', 10, 2, 'X')  |
+-------------------------------+
| Hello                         |
+-------------------------------+

4. NULL値の処理

SELECT overlay('Hello', NULL, 2, 'X');

+--------------------------------+
| overlay('Hello', NULL, 2, 'X') |
+--------------------------------+
| NULL                           |
+--------------------------------+

SELECT INSERT('🎉🎊🎈', 2, 1, '🎁');

+--------------------------------------+
| INSERT('🎉🎊🎈', 2, 1, '🎁')                 |
+--------------------------------------+
| 🎉🎁🎈                                     |
+--------------------------------------+