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

TRIM_IN

説明​

TRIM_IN関数は、文字列の先頭と末尾から指定された文字を削除するために使用されます。文字セットが指定されていない場合、デフォルトで先頭と末尾のスペースを削除します。文字セットが指定されている場合、両端から指定されたすべての文字を削除します（セット内での順序に関係なく）。

TRIM_INの主な特徴は、指定されたセットから文字の任意の組み合わせを削除することです。一方、TRIM関数は完全な文字列マッチングに基づいて文字を削除します。

構文​

TRIM_IN(<str>[, <rhs>])

パラメータ​

Parameterデスクリプション
<str>処理される文字列。型: VARCHAR
<rhs>オプションパラメータ、削除される文字のセット。型: VARCHAR

Return Value​

VARCHAR型を返し、処理された文字列を表します。

特殊なケース:

  • strがNULLの場合、NULLを返します
  • rhsが指定されていない場合、先頭と末尾のすべてのスペースを削除します
  • rhsが指定されている場合、rhsに含まれていない文字に遭遇するまで、両端からrhsに含まれるすべての文字を削除します

Examples​

  1. 先頭と末尾のスペースを削除
SELECT trim_in('   ab d   ') str;
+------+
| str  |
+------+
| ab d |
+------+
  1. 指定した文字セットを削除する
SELECT trim_in('ababccaab', 'ab') str;
+------+
| str  |
+------+
| cc   |
+------+
  1. TRIM関数との比較
SELECT trim_in('ababccaab', 'ab'), trim('ababccaab', 'ab');
+-----------------------------+--------------------------+
| trim_in('ababccaab', 'ab')  | trim('ababccaab', 'ab')  |
+-----------------------------+--------------------------+
| cc                          | ababccaab                |
+-----------------------------+--------------------------+
  1. 文字セットの順序は重要ではありません
SELECT trim_in('abcHelloabc', 'cba');
+--------------------------------+
| trim_in('abcHelloabc', 'cba')  |
+--------------------------------+
| Hello                          |
+--------------------------------+
  1. UTF-8文字サポート
SELECT trim_in('+++ṭṛì ḍḍumai+++', '+');
+--------------------------------------+
| trim_in('+++ṭṛì ḍḍumai+++', '+')    |
+--------------------------------------+
| ṭṛì ḍḍumai                           |
+--------------------------------------+
  1. NULL値の処理
SELECT trim_in(NULL, 'abc');
+-----------------------+
| trim_in(NULL, 'abc')  |
+-----------------------+
| NULL                  |
+-----------------------+
  1. 空文字の処理
SELECT trim_in('', 'abc'), trim_in('abc', '');
+--------------------+--------------------+
| trim_in('', 'abc') | trim_in('abc', '') |
+--------------------+--------------------+
|                    | abc                |
+--------------------+--------------------+

Keywords​

TRIM_IN, TRIM