In MariaDB, LOWER()
is een ingebouwde tekenreeksfunctie die het tekenreeksargument retourneert met alle tekens veranderd in kleine letters.
Het resultaat wordt geretourneerd in de huidige tekensettoewijzing. De standaard is latin1
(cp1252 West-Europees).
Een andere MariaDB-functie, LCASE()
is een synoniem voor LOWER()
.
Syntaxis
De syntaxis gaat als volgt:
LOWER(str)
Waar str
is de tekenreeks die moet worden geconverteerd naar kleine letters.
Voorbeeld
Hier is een eenvoudig voorbeeld:
SELECT LOWER('Crazy Clown');
Resultaat:
+----------------------+ | LOWER('Crazy Clown') | +----------------------+ | crazy clown | +----------------------+
Hier is nog een voorbeeld:
SELECT LOWER('FAST ELEPHANT');
Resultaat:
+------------------------+ | LOWER('FAST ELEPHANT') | +------------------------+ | fast elephant | +------------------------+
Een databasevoorbeeld
Hier is een voorbeeld van het converteren van de resultaten van een databasequery naar kleine letters:
SELECT
StateProvince,
LOWER(StateProvince)
FROM Vendors;
Resultaat:
+---------------+----------------------+ | StateProvince | LOWER(StateProvince) | +---------------+----------------------+ | MI | mi | | QLD | qld | | CA | ca | | NULL | NULL | | NULL | NULL | +---------------+----------------------+
Binaire strings
De LOWER()
functie werkt niet op binaire strings (BINARY
, VARBINARY
, BLOB
).
Voorbeeld:
SELECT LOWER(BINARY 'FAST ELEPHANT');
Resultaat:
+-------------------------------+ | LOWER(BINARY 'FAST ELEPHANT') | +-------------------------------+ | FAST ELEPHANT | +-------------------------------+
Nullargumenten
Doorgeven van null
retourneert null
:
SELECT LOWER(null);
Resultaat:
+-------------+ | LOWER(null) | +-------------+ | NULL | +-------------+
Ontbrekend argument
LOWER()
. aanroepen zonder het doorgeven van argumenten resulteert in een fout:
SELECT LOWER();
Resultaat:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'LOWER'