...
Eroare Kotlin · Biblioteca standard, Java și formatare

'fun String.toUpperCase(): String' is deprecated. Use uppercase() instead.

Pe scurt

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

Greșit
KOTLIN
fun main() {
    println("ana".toUpperCase())
    println("ION".toLowerCase())
}
Corect
KOTLIN
fun main() {
    println("ana".uppercase())
    println("ION".lowercase())
}

uppercase()/lowercase() sunt înlocuitorii direcți.

2Prima literă mare

Greșit
KOTLIN
fun main() {
    println("bucuresti".capitalize())
}
Corect
KOTLIN
fun main() {
    println("bucuresti".replaceFirstChar { it.uppercase() })
}

replaceFirstChar transformă doar primul caracter; restul rămâne neschimbat.

Repară tu

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).

Codul care dă eroarea
KOTLIN
fun main() {
    val nume = "Popescu"
    println("Utilizator: ${nume.toUpperCase()} (${nume.toLowerCase()})")
}
După reparație, programul afișează
Utilizator: POPESCU (popescu)
Indiciu

toUpperCase() devine uppercase(), toLowerCase() devine lowercase().

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

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.