...
Eroare Kotlin · Tipuri și type mismatch

Type argument is not within its bounds: type parameter 'T (of class Cutie<T : Number>)' must be subtype of 'Number', but actual: 'String'

Pe scurt

Clasa sau funcția generică cere ca T să fie de un anumit tip (de exemplu T : Number), iar tu i-ai dat altul (String). Folosește un tip care respectă limita (Int, Double) sau, dacă limita e greșită, schimb-o în declarația generică.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

La o declarație generică poți pune o limită superioară: class Cutie<T : Number> înseamnă „T poate fi doar Number sau un subtip al lui (Int, Double, Long...)”. Limita îți dă voie să folosești în clasă metodele lui Number, de exemplu toDouble().

Mesajul îți spune exact:

  • type parameter 'T (of class Cutie<T : Number>)': ce parametru și ce limită are;
  • must be subtype of 'Number': ce cere limita;
  • but actual: 'String': ce tip ai dat tu.

Apare când scrii tipul explicit (Cutie<String>) sau când o funcție generică cu limită (fun <T : Comparable<T>> maxim(...)) primește o clasă care nu implementează interfața cerută. De obicei vine împreună cu un Argument type mismatch sau Inapplicable candidate(s) pe același rând.

De ce apare: cauzele frecvente

1Tip explicit care nu respectă limita

Greșit
KOTLIN
class Cutie<T : Number>(val v: T) {
    fun dublu() = v.toDouble() * 2
}
fun main() {
    val c = Cutie<String>("5")
}
Corect
KOTLIN
class Cutie<T : Number>(val v: T) {
    fun dublu() = v.toDouble() * 2
}
fun main() {
    val c = Cutie<Int>(5)
    println(c.dublu())
}

Int este subtip de Number, deci respectă limita; String nu este.

2Clasa nu implementează Comparable

Greșit
KOTLIN
class Elev(val nota: Int)
fun <T : Comparable<T>> maxim(a: T, b: T) = if (a > b) a else b
fun main() {
    maxim<Elev>(Elev(9), Elev(7))
}
Corect
KOTLIN
class Elev(val nota: Int) : Comparable<Elev> {
    override fun compareTo(other: Elev) = nota.compareTo(other.nota)
}
fun <T : Comparable<T>> maxim(a: T, b: T) = if (a > b) a else b
fun main() {
    println(maxim(Elev(9), Elev(7)).nota)
}

Limita cere Comparable<T>; după ce Elev o implementează, tipul o respectă.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos ține o statistică generică pentru valori numerice, dar nu compilează: Type argument is not within its bounds ... must be subtype of 'Number', but actual: 'String'. Repară crearea statisticii (fără să schimbi clasa) ca să lucreze cu numere și să afișeze Media: 8.0.

Codul care dă eroarea
KOTLIN
class Statistica<T : Number>(val valori: List<T>) {
    fun media() = valori.sumOf { it.toDouble() } / valori.size
}

fun main() {
    val s = Statistica<String>(listOf("7", "8", "9"))
    println("Media: ${s.media()}")
}
După reparație, programul afișează
Media: 8.0
Indiciu

Folosește Int ca tip și dă valorile ca numere, nu ca texte.

Alte forme ale mesajului

  • error: type argument is not within its bounds: type parameter 'T (of class Cutie<T : Number>)' must be subtype of 'Number', but actual: 'String'.
  • Type argument is not within its bounds

Cum o eviți pe viitor

Pune limite generice doar când chiar folosești în cod ceva din tipul-limită (o metodă, un operator). Când scrii o clasă care va fi sortată, comparată sau folosită cu maxOf, implementează Comparable de la început. Lasă compilatorul să deducă tipul (Cutie(5)) în loc să-l scrii manual: așa vezi imediat dacă valoarea respectă limita.

Întrebări frecvente

Pot pune mai multe limite pe T?

Da, cu where: fun <T> f(x: T) where T : Number, T : Comparable<T>. Tipul dat trebuie să le respecte pe toate.

De ce limita implicită e Any? și nu Any?

Fără limită scrisă, T poate fi orice, inclusiv un tip nullable. Dacă vrei să interzici null, scrie T : Any.

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.