substring

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