In MariaDB, UCASE()
is een ingebouwde tekenreeksfunctie die het tekenreeksargument retourneert met alle tekens veranderd in hoofdletters.
Het resultaat wordt geretourneerd in de huidige tekensettoewijzing. De standaard is latin1
(cp1252 West-Europees).
UCASE()
is een synoniem voor UPPER()
.
Syntaxis
De syntaxis gaat als volgt:
UCASE(str)
Waar str
is de tekenreeks die moet worden omgezet in hoofdletters.
Voorbeeld
Hier is een eenvoudig voorbeeld:
SELECT UCASE('Freedom!!!');
Resultaat:
+---------------------+ | UCASE('Freedom!!!') | +---------------------+ | FREEDOM!!! | +---------------------+
Een databasevoorbeeld
Hier is een voorbeeld van het converteren van de resultaten van een databasequery naar hoofdletters:
SELECT
City,
UCASE(City)
FROM Vendors;
Resultaat:
+-------------+-------------+ | City | UCASE(City) | +-------------+-------------+ | Smith City | SMITH CITY | | Edmonton | EDMONTON | | Strict Town | STRICT TOWN | | Timaru | TIMARU | | Dunedin | DUNEDIN | +-------------+-------------+
Binaire strings
De UCASE()
functie werkt niet op binaire strings (BINARY
, VARBINARY
, BLOB
).
Voorbeeld:
SELECT UCASE(BINARY 'Library');
Resultaat:
+-------------------------+ | UCASE(BINARY 'Library') | +-------------------------+ | Library | +-------------------------+
Nullargumenten
Doorgeven van null
retourneert null
:
SELECT UCASE(null);
Resultaat:
+-------------+ | UCASE(null) | +-------------+ | NULL | +-------------+
Ontbrekend argument
UCASE()
. aanroepen zonder het doorgeven van argumenten resulteert in een fout:
SELECT UCASE();
Resultaat:
ERROR 1582 (42000): Incorrect parameter count in the call to native function 'UCASE'