メインコンテンツまでスキップ
バージョン: Latest-3.4

substring_index

区切り文字のcount回出現する前または後の部分文字列を抽出します。

  • countが正の場合、文字列の先頭からカウントが始まり、この関数はcount番目の区切り文字の前の部分文字列を返します。例えば、select substring_index('https://www.starrocks.io', '.', 2);は、2番目の.区切り文字の前の部分文字列であるhttps://www.starrocksを返します。

  • countが負の場合、文字列の末尾からカウントが始まり、この関数はcount番目の区切り文字の後の部分文字列を返します。例えば、select substring_index('https://www.starrocks.io', '.', -2);は、2番目の.区切り文字の後の部分文字列であるstarrocks.ioを返します。

いずれかの入力パラメータがnullの場合、NULLが返されます。

この関数はv3.2からサポートされています。

Syntax​

VARCHAR substring_index(VARCHAR str, VARCHAR delimiter, INT count)

Parameters​

  • str: 必須、分割したい文字列。
  • delimiter: 必須、文字列を分割するために使用される区切り文字。
  • count: 必須、区切り文字の位置。値は0にできません。そうでない場合、NULLが返されます。値が文字列内の実際の区切り文字の数より大きい場合、文字列全体が返されます。

Return value​

VARCHAR値を返します。

Examples​

-- 2番目の"."区切り文字の前の部分文字列を返します。
mysql> select substring_index('https://www.starrocks.io', '.', 2);
+-----------------------------------------------------+
| substring_index('https://www.starrocks.io', '.', 2) |
+-----------------------------------------------------+
| https://www.starrocks                               |
+-----------------------------------------------------+

-- countが負の場合。
mysql> select substring_index('https://www.starrocks.io', '.', -2);
+------------------------------------------------------+
| substring_index('https://www.starrocks.io', '.', -2) |
+------------------------------------------------------+
| starrocks.io                                         |
+------------------------------------------------------+

mysql> select substring_index("hello world", " ", 1);
+----------------------------------------+
| substring_index("hello world", " ", 1) |
+----------------------------------------+
| hello                                  |
+----------------------------------------+

mysql> select substring_index("hello world", " ", -1);
+-----------------------------------------+
| substring_index('hello world', ' ', -1) |
+-----------------------------------------+
| world                                   |
+-----------------------------------------+

-- countが0でNULLが返されます。
mysql> select substring_index("hello world", " ", 0);
+----------------------------------------+
| substring_index('hello world', ' ', 0) |
+----------------------------------------+
| NULL                                   |
+----------------------------------------+

-- countが文字列内のスペースの数より大きく、文字列全体が返されます。
mysql> select substring_index("hello world", " ", 2);
+----------------------------------------+
| substring_index("hello world", " ", 2) |
+----------------------------------------+
| hello world                            |
+----------------------------------------+

-- countが文字列内のスペースの数より大きく、文字列全体が返されます。
mysql> select substring_index("hello world", " ", -2);
+-----------------------------------------+
| substring_index("hello world", " ", -2) |
+-----------------------------------------+
| hello world                             |
+-----------------------------------------+

keyword​

substring_index