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

STRLEFT

デスクリプション​

STRLEFT関数は、文字列の左側から指定された文字数を返します。長さはUTF8文字で測定されます。

Alias​

LEFT

Syntax​

STRLEFT(<str>, <len>)

パラメータ​

Parameterデスクリプション
<str>抽出元の文字列。型: VARCHAR
<len>返す文字数。型: INT

戻り値​

抽出された部分文字列を表すVARCHAR型を返します。

特殊なケース:

  • いずれかの引数がNULLの場合、NULLを返す
  • lenが0以下の場合、空文字列""を返す
  • lenが文字列長より大きい場合、文字列全体を返す

例​

  1. 基本的な左側抽出
SELECT STRLEFT('Hello doris', 5), LEFT('Hello doris', 5);
+---------------------------+----------------------+
| STRLEFT('Hello doris', 5) | LEFT('Hello doris', 5) |
+---------------------------+----------------------+
| Hello                     | Hello                |
+---------------------------+----------------------+
  1. 異なる抽出長
SELECT STRLEFT('Hello World', 3), STRLEFT('Hello World', 8);
+----------------------------+----------------------------+
| STRLEFT('Hello World', 3)  | STRLEFT('Hello World', 8)  |
+----------------------------+----------------------------+
| Hel                        | Hello Wo                   |
+----------------------------+----------------------------+
  1. NULL値の処理
SELECT STRLEFT(NULL, 5), STRLEFT('Hello doris', NULL);
+------------------+------------------------------+
| STRLEFT(NULL, 5) | STRLEFT('Hello doris', NULL) |
+------------------+------------------------------+
| NULL             | NULL                         |
+------------------+------------------------------+
  1. 空文字列と長さゼロ
SELECT STRLEFT('', 5), STRLEFT('Hello World', 0);
+------------------+----------------------------+
| STRLEFT('', 5)   | STRLEFT('Hello World', 0)  |
+------------------+----------------------------+
|                  |                            |
+------------------+----------------------------+
  1. 負の長さの処理
SELECT STRLEFT('Hello doris', -5), STRLEFT('Hello doris', -1);
+-----------------------------+----------------------------+
| STRLEFT('Hello doris', -5)  | STRLEFT('Hello doris', -1) |
+-----------------------------+----------------------------+
|                             |                            |
+-----------------------------+----------------------------+
  1. 長さが文字列長を超過しています
SELECT STRLEFT('ABC', 10), STRLEFT('short', 20);
+--------------------+----------------------+
| STRLEFT('ABC', 10) | STRLEFT('short', 20) |
+--------------------+----------------------+
| ABC                | short                |
+--------------------+----------------------+
  1. UTF-8マルチバイト文字
SELECT STRLEFT('ṭṛì ḍḍumai hello', 3), STRLEFT('ṭṛì ḍḍumai hello', 7);
+---------------------------------+----------------------------------+
| STRLEFT('ṭṛì ḍḍumai hello', 3)  | STRLEFT('ṭṛì ḍḍumai hello', 7)  |
+---------------------------------+----------------------------------+
| ṭṛì                             | ṭṛì ḍḍu                          |
+---------------------------------+----------------------------------+
  1. 番号とIDプレフィックス
SELECT STRLEFT('ID123456789', 5), STRLEFT('USER_987654321', 5);
+----------------------------+------------------------------+
| STRLEFT('ID123456789', 5)  | STRLEFT('USER_987654321', 5) |
+----------------------------+------------------------------+
| ID123                      | USER_                        |
+----------------------------+------------------------------+

Keywords​

STRLEFT, LEFT