Dans MariaDB, LOWER()
est une fonction de chaîne intégrée qui renvoie son argument de chaîne avec tous les caractères changés en minuscules.
Le résultat est renvoyé dans le mappage du jeu de caractères actuel. La valeur par défaut est latin1
(cp1252 Europe de l'Ouest).
Une autre fonction MariaDB, LCASE()
est un synonyme de LOWER()
.
Syntaxe
La syntaxe ressemble à ceci :
LOWER(str)
Où str
est la chaîne à convertir en minuscules.
Exemple
Voici un exemple de base :
SELECT LOWER('Crazy Clown');
Résultat :
+----------------------+ | LOWER('Crazy Clown') | +----------------------+ | crazy clown | +----------------------+
Voici un autre exemple :
SELECT LOWER('FAST ELEPHANT');
Résultat :
+------------------------+ | LOWER('FAST ELEPHANT') | +------------------------+ | fast elephant | +------------------------+
Un exemple de base de données
Voici un exemple de conversion des résultats d'une requête de base de données en minuscules :
SELECT
StateProvince,
LOWER(StateProvince)
FROM Vendors;
Résultat :
+---------------+----------------------+ | StateProvince | LOWER(StateProvince) | +---------------+----------------------+ | MI | mi | | QLD | qld | | CA | ca | | NULL | NULL | | NULL | NULL | +---------------+----------------------+
Chaînes binaires
Le LOWER()
la fonction ne fonctionne pas sur les chaînes binaires (BINARY
, VARBINARY
, BLOB
).
Exemple :
SELECT LOWER(BINARY 'FAST ELEPHANT');
Résultat :
+-------------------------------+ | LOWER(BINARY 'FAST ELEPHANT') | +-------------------------------+ | FAST ELEPHANT | +-------------------------------+
Arguments nuls
Passer null
renvoie null
:
SELECT LOWER(null);
Résultat :
+-------------+ | LOWER(null) | +-------------+ | NULL | +-------------+
Argument manquant
Appel de LOWER()
sans passer d'arguments entraîne une erreur :
SELECT LOWER();
Résultat :
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'LOWER'