MariaDBでは、LOWER()
は、すべての文字が小文字に変更された文字列引数を返す組み込みの文字列関数です。
結果は、現在の文字セットマッピングで返されます。デフォルトはlatin1
(cp1252西ヨーロッパ)。
もう1つのMariaDB関数、LCASE()
LOWER()
の同義語です 。
構文
構文は次のようになります:
LOWER(str)
str
小文字に変換する文字列です。
例
基本的な例は次のとおりです。
SELECT LOWER('Crazy Clown');
結果:
+----------------------+ | LOWER('Crazy Clown') | +----------------------+ | crazy clown | +----------------------+
別の例を次に示します。
SELECT LOWER('FAST ELEPHANT');
結果:
+------------------------+ | LOWER('FAST ELEPHANT') | +------------------------+ | fast elephant | +------------------------+
データベースの例
データベースクエリの結果を小文字に変換する例を次に示します。
SELECT
StateProvince,
LOWER(StateProvince)
FROM Vendors;
結果:
+---------------+----------------------+ | StateProvince | LOWER(StateProvince) | +---------------+----------------------+ | MI | mi | | QLD | qld | | CA | ca | | NULL | NULL | | NULL | NULL | +---------------+----------------------+
バイナリ文字列
LOWER()
関数はバイナリ文字列では機能しません(BINARY
、VARBINARY
、BLOB
。
例:
SELECT LOWER(BINARY 'FAST ELEPHANT');
結果:
+-------------------------------+ | LOWER(BINARY 'FAST ELEPHANT') | +-------------------------------+ | FAST ELEPHANT | +-------------------------------+
ヌル引数
null
を渡す null
を返します :
SELECT LOWER(null);
結果:
+-------------+ | LOWER(null) | +-------------+ | NULL | +-------------+
引数がありません
LOWER()
を呼び出す 引数を渡さないとエラーが発生します:
SELECT LOWER();
結果:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'LOWER'