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

LTRIM

説明​

LTRIM関数は、文字列の左側（先頭）から連続する空白または指定された文字セットを削除します。この関数は文字列の左端からスキャンし、対象文字セットに含まれない文字に遭遇するまで、すべての連続する対象文字を削除します。

構文​

LTRIM(<str> [, <trim_chars>])

パラメータ​

Parameterデスクリプション
<str>左トリミングされる元の文字列。型: VARCHAR
<trim_chars>オプションパラメータ、削除する文字セットを指定します。指定されない場合、デフォルトでスペース文字を削除します。型: VARCHAR

戻り値​

VARCHAR型を返し、左側から指定された文字を削除した後の文字列を表します。

トリミング規則:

  • 文字列の左側（先頭）からのみ文字を削除します
  • trim_charsに含まれる連続する文字をすべて削除します
  • trim_charsに含まれない文字に遭遇すると削除を停止します
  • trim_charsが指定されない場合、デフォルトでスペース文字（スペース、タブ、改行など）を削除します

特殊ケース:

  • いずれかのパラメータがNULLの場合、NULLを返します
  • strが空文字列の場合、空文字列を返します
  • trim_charsが空文字列の場合、元の文字列を返します
  • 文字列全体がtrim_charsの文字で構成されている場合、空文字列を返します

例​

  1. 左側のスペースを削除
SELECT LTRIM('   ab d');
+-------------------+
| LTRIM('   ab d')  |
+-------------------+
| ab d              |
+-------------------+
  1. 指定された文字を削除する
SELECT LTRIM('ababccaab', 'ab');
+----------------------------+
| LTRIM('ababccaab', 'ab')   |
+----------------------------+
| ccaab                      |
+----------------------------+
  1. NULL値の処理
SELECT LTRIM(NULL), LTRIM('test', NULL);
+-------------+---------------------+
| LTRIM(NULL) | LTRIM('test', NULL) |
+-------------+---------------------+
| NULL        | NULL                |
+-------------+---------------------+