MySQLのINSERT()関数で「pos」が文字列の長さの範囲外の場合、結果はどうなる？

MySQLのINSERT()関数は、挿入位置を示す「pos」が元の文字列の長さの範囲内にない場合、挿入処理を実行せず、元の文字列をそのまま返します。

「pos」が範囲外とみなされるのは、主に次のようなケースです。

• posに負の値を指定した場合
• posに0（ゼロ）を指定した場合
• posが元の文字列の文字数を2以上超える場合

それぞれのケースについて、以下の具体例で動作を確認していきましょう。

例1：posに負の値を指定した場合

次のクエリでは、posに-1という負の値を指定しています。このため位置が文字列の長さの範囲外となり、挿入は行われず元の文字列がそのまま返されます。

mysql> Select INSERT('Tutorialspoint',-1,4,'.com');
+--------------------------------------+
| INSERT('Tutorialspoint',-1,4,'.com') |
+--------------------------------------+
| Tutorialspoint                       |
+--------------------------------------+
1 row in set (0.00 sec)

例2：posに0を指定した場合

次のクエリでは、posに0を指定しています。文字列の位置は1から始まるため、0は範囲外と判断され、挿入は実行されません。

mysql> Select INSERT('Tutorialspoint',0,4,'.com');
+-------------------------------------+
| INSERT('Tutorialspoint',0,4,'.com') |
+-------------------------------------+
| Tutorialspoint                      |
+-------------------------------------+
1 row in set (0.00 sec)

例3：posが文字数を大きく超える場合

次のクエリでは、元の文字列「Tutorialspoint」は14文字ですが、posに16を指定しています。有効な位置は最大でも「文字数＋1」までなので、16は文字数を2超える値となり範囲外です。その結果、挿入は行われません。

mysql> Select INSERT('Tutorialspoint',16,4,'.com');
+--------------------------------------+
| INSERT('Tutorialspoint',16,4,'.com') |
+--------------------------------------+
| Tutorialspoint                       |
+--------------------------------------+
1 row in set (0.00 sec)

補足：正常に挿入が行われるケースとの違い

一方、posが「文字数＋1」以内であれば挿入は正常に実行されます。特にposが「文字数＋1」の場合、newstrは文字列の末尾に追加されます。また、lenが残りの文字数を超えている場合は、pos以降のすべての文字がnewstrで置き換えられます。さらに、引数のいずれかにNULLが含まれる場合はNULLが返される点にも注意してください。