'fun String.toUpperCase(): String' is deprecated. Use uppercase() instead.
Codul folosește o funcție veche din biblioteca standard, scoasă din uz (toUpperCase, toLowerCase, capitalize). În Kotlin 2.x apelul e eroare de compilare. Înlocuiește cu varianta nouă: uppercase(), lowercase(), replaceFirstChar { it.uppercase() }.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Kotlin marchează funcțiile învechite cu @Deprecated și le scoate treptat: întâi warning, apoi error, apoi le ascunde. toUpperCase() și toLowerCase() depindeau de limba sistemului (de exemplu în turcă "i".toUpperCase() dă İ) și au fost înlocuite din Kotlin 1.5 cu uppercase() și lowercase(), care folosesc mereu reguli independente de limbă.
În versiunile 2.x, apelul vechi nu mai compilează. Mesajul îți spune exact funcția veche și înlocuitorul. Același tipar apare la capitalize() → replaceFirstChar { it.uppercase() }, Char.toInt() → code, sumBy → sumOf, String.toRegex() cu opțiuni vechi și altele.
Apare des când copiezi cod din tutoriale sau răspunsuri vechi.
De ce apare: cauzele frecvente
1Funcții de majuscule vechi
fun main() {
println("ana".toUpperCase())
println("ION".toLowerCase())
}fun main() {
println("ana".uppercase())
println("ION".lowercase())
}uppercase()/lowercase() sunt înlocuitorii direcți.
2Prima literă mare
fun main() {
println("bucuresti".capitalize())
}fun main() {
println("bucuresti".replaceFirstChar { it.uppercase() })
}replaceFirstChar transformă doar primul caracter; restul rămâne neschimbat.
Repară eroarea, direct în pagină
Programul de mai jos formatează un nume de utilizator cu funcții vechi, copiate dintr-un tutorial, și nu compilează: 'fun String.toUpperCase(): String' is deprecated. Use uppercase() instead. Înlocuiește apelurile vechi ca programul să afișeze Utilizator: POPESCU (popescu).
fun main() {
val nume = "Popescu"
println("Utilizator: ${nume.toUpperCase()} (${nume.toLowerCase()})")
}Utilizator: POPESCU (popescu)
Indiciu
toUpperCase() devine uppercase(), toLowerCase() devine lowercase().
Reparația
fun main() {
val nume = "Popescu"
println("Utilizator: ${nume.uppercase()} (${nume.lowercase()})")
}De ce merge
toUpperCase() și toLowerCase() sunt depreciate din Kotlin 1.5, iar în versiunea folosită aici sunt eroare de compilare. uppercase() și lowercase() fac aceeași transformare, independent de limba sistemului, deci rezultatul e POPESCU și popescu. În IntelliJ, Alt+Enter pe apelul vechi face înlocuirea automat, pentru tot fișierul.
Alte forme ale mesajului
error: 'fun String.toUpperCase(): String' is deprecated. Use uppercase() instead.'toUpperCase(): String' is deprecated. Use uppercase() instead.'fun String.toLowerCase(): String' is deprecated. Use lowercase() instead.'fun String.capitalize(): String' is deprecated. Use replaceFirstChar instead.
Cum o eviți pe viitor
Când copiezi cod Kotlin vechi, caută mai întâi avertismentele de depreciere și înlocuiește funcțiile înainte să faci upgrade la o versiune nouă de Kotlin. În IntelliJ, Alt+Enter pe un apel tăiat cu o linie îți propune automat înlocuirea. Nu ignora warning-urile deprecated: în versiunea următoare devin erori.
Întrebări frecvente
De ce în proiectul vechi compila și acum nu?
Proiectul a trecut la o versiune mai nouă de Kotlin, în care nivelul deprecierii a crescut de la warning la error. Codul trebuie actualizat la funcțiile noi.
uppercase() ține cont de diacritice?
Da: "ștefan".uppercase() dă ȘTEFAN. Diferența față de varianta veche este doar că nu depinde de limba sistemului.
Erori înrudite
Unresolved reference 'totl' Compilatorul nu găsește niciun nume totl: nu există o variabilă, funcție sau clasă cu numele ăsta în locul în care l-ai folosit. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau un import lipsă. Corectează numele sau declară-l. Named arguments are prohibited for non-Kotlin functions Ai folosit argumente cu nume (a = 3) la o funcție scrisă în Java (Math.max, String.format, metodele unei biblioteci Java). Pentru funcțiile Java, Kotlin nu garantează numele parametrilor, deci acceptă doar argumente după poziție: Math.max(3, 5). Expression 'size' of type 'Int' cannot be invoked as a function. Function 'invoke()' is not found. Ai pus paranteze după ceva care e proprietate, nu funcție: lista.size(), text.length(), map.keys(). În Kotlin acestea se scriu fără paranteze: lista.size, text.length. Mesajul apare și când apelezi o variabilă obișnuită ca pe o funcție. Învață Kotlin de la zero, cu exerciții la fiecare lecție
Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
