MariaDBでは、LCASE()
は、すべての文字が小文字に変更された文字列引数を返す組み込みの文字列関数です。
結果は、現在の文字セットマッピングで返されます。デフォルトはlatin1
(cp1252西ヨーロッパ)。
LCASE()
LOWER()
の同義語です 。
構文
構文は次のようになります:
LCASE(str)
str
小文字に変換する文字列です。
例
基本的な例は次のとおりです。
SELECT LCASE('Take Five');
結果:
+--------------------+ | LCASE('Take Five') | +--------------------+ | take five | +--------------------+
別の例を次に示します。
SELECT LCASE('SIDEKICK');
結果:
+-------------------+ | LCASE('SIDEKICK') | +-------------------+ | sidekick | +-------------------+
データベースの例
データベースクエリの結果を小文字に変換する例を次に示します。
SELECT
PetName,
LCASE(PetName)
FROM Pets;
結果:
+---------+----------------+ | PetName | LCASE(PetName) | +---------+----------------+ | Fluffy | fluffy | | Fetch | fetch | | Scratch | scratch | | Wag | wag | | Tweet | tweet | | Fluffy | fluffy | | Bark | bark | | Meow | meow | +---------+----------------+
バイナリ文字列
LCASE()
バイナリ文字列では機能しません(BINARY
、VARBINARY
、BLOB
。
例:
SELECT LCASE(BINARY 'SIDEKICK');
結果:
+--------------------------+ | LCASE(BINARY 'SIDEKICK') | +--------------------------+ | SIDEKICK | +--------------------------+
ヌル引数
null
を渡す null
を返します :
SELECT LCASE(null);
結果:
+-------------+ | LCASE(null) | +-------------+ | NULL | +-------------+
引数がありません
LCASE()
の呼び出し 引数を渡さないとエラーが発生します:
SELECT LCASE();
結果:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'LCASE'