W MariaDB, LOWER()
jest wbudowaną funkcją łańcuchową, która zwraca swój argument łańcuchowy ze wszystkimi znakami zamienionymi na małe litery.
Wynik jest zwracany w bieżącym odwzorowaniu zestawu znaków. Wartość domyślna to latin1
(cp1252 Europa Zachodnia).
Inna funkcja MariaDB, LCASE()
jest synonimem LOWER()
.
Składnia
Składnia wygląda tak:
LOWER(str)
Gdzie str
jest ciągiem do konwersji na małe litery.
Przykład
Oto podstawowy przykład:
SELECT LOWER('Crazy Clown');
Wynik:
+----------------------+ | LOWER('Crazy Clown') | +----------------------+ | crazy clown | +----------------------+
Oto kolejny przykład:
SELECT LOWER('FAST ELEPHANT');
Wynik:
+------------------------+ | LOWER('FAST ELEPHANT') | +------------------------+ | fast elephant | +------------------------+
Przykład bazy danych
Oto przykład konwersji wyników zapytania do bazy danych na małe litery:
SELECT
StateProvince,
LOWER(StateProvince)
FROM Vendors;
Wynik:
+---------------+----------------------+ | StateProvince | LOWER(StateProvince) | +---------------+----------------------+ | MI | mi | | QLD | qld | | CA | ca | | NULL | NULL | | NULL | NULL | +---------------+----------------------+
Ciągi binarne
LOWER()
funkcja nie działa na ciągach binarnych (BINARY
, VARBINARY
, BLOB
).
Przykład:
SELECT LOWER(BINARY 'FAST ELEPHANT');
Wynik:
+-------------------------------+ | LOWER(BINARY 'FAST ELEPHANT') | +-------------------------------+ | FAST ELEPHANT | +-------------------------------+
Argumenty zerowe
Przekazywanie null
zwraca null
:
SELECT LOWER(null);
Wynik:
+-------------+ | LOWER(null) | +-------------+ | NULL | +-------------+
Brakujący argument
Wywołanie LOWER()
bez przekazania żadnych argumentów powoduje błąd:
SELECT LOWER();
Wynik:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'LOWER'