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

STRLEFT

説明​

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

エイリアス​

LEFT

構文​

STRLEFT(<str>, <len>)

パラメータ​

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

戻り値​

抽出されたサブストリングを表すVARCHAR型を返します。

特殊なケース:

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

例​

  1. 基本的な使用方法
SELECT strleft('Hello doris', 5);
+---------------------------+
| strleft('Hello doris', 5) |
+---------------------------+
| Hello                     |
+---------------------------+
  1. 負の長さの処理
SELECT strleft('Hello doris', -5);
+----------------------------+
| strleft('Hello doris', -5) |
+----------------------------+
|                            |
+----------------------------+
  1. NULLパラメータの処理
SELECT strleft('Hello doris', NULL);
+------------------------------+
| strleft('Hello doris', NULL) |
+------------------------------+
| NULL                         |
+------------------------------+
  1. NULL文字列の処理
SELECT strleft(NULL, 3);
+------------------+
| strleft(NULL, 3) |
+------------------+
| NULL             |
+------------------+