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

substring, substr

説明

文字列から文字を抽出し、サブストリングを返します。

len が指定されていない場合、この関数は pos で指定された位置から文字を抽出します。len が指定されている場合、この関数は pos で指定された位置から len 文字を抽出します。

pos は負の整数であることもできます。この場合、この関数は文字列の末尾から文字を抽出します。

構文

VARCHAR substr(VARCHAR str, pos[, len])

パラメータ

  • str: 文字を抽出する文字列。必須です。VARCHAR 値である必要があります。
  • pos: 開始位置。必須です。文字列の最初の位置は 1 です。
  • length: 抽出する文字数。オプションです。正の整数である必要があります。

戻り値

VARCHAR 型の値を返します。

返す文字数 (len) が一致する文字の実際の長さを超える場合、一致するすべての文字が返されます。

pos で指定された位置が文字列の範囲を超える場合、空の文字列が返されます。

MySQL > select substring("starrockscluster", 1, 9);
+-------------------------------------+
| substring('starrockscluster', 1, 9) |
+-------------------------------------+
| starrocks |
+-------------------------------------+

MySQL > select substring("starrocks", -5, 5);
+-------------------------------+
| substring('starrocks', -5, 5) |
+-------------------------------+
| rocks |
+-------------------------------+

MySQL > select substring("apple", 1, 9);
+--------------------------+
| substring('apple', 1, 9) |
+--------------------------+
| apple |
+--------------------------+

キーワード

substring, string, sub