...
Eroare Kotlin · Tipuri și type mismatch

Receiver type 'MutableList<out Number>' contains out projection which prohibits the use of 'fun add(element: E): Boolean'

Pe scurt

Parametrul e declarat MutableList<out Number>, deci din listă poți doar citi: compilatorul nu știe dacă e o listă de Int, de Double sau de alt Number, așa că interzice add. Dacă trebuie să adaugi, declară-l MutableList<Number> sau MutableList<in Int>.

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

Ce înseamnă

out (covarianță) îi spune compilatorului: „lista asta produce valori de tip Number sau subtipuri”. O MutableList<out Number> poate fi de fapt o MutableList<Int> sau o MutableList<Double>. Citirea e sigură (orice element e un Number), dar scrierea nu: dacă ai adăuga un Double într-o listă care e de fapt de Int, ai strica lista. De aceea toate metodele care primesc un E (add, set, addAll) sunt interzise, iar mesajul numește exact metoda blocată.

Invers, in (contravarianță) permite scrierea și restricționează citirea: MutableList<in Int> acceptă add(5), dar elementele citite sunt doar Any?.

În Kotlin 1.x mesajul era Out-projected type 'MutableList<out Number>' prohibits the use of 'public abstract fun add(element: E): Boolean'.

De ce apare: cauzele frecvente

1Funcție care adaugă într-o listă out

Greșit
KOTLIN
fun adaugaZero(l: MutableList<out Number>) {
    l.add(0)
}
Corect
KOTLIN
fun adaugaZero(l: MutableList<in Int>) {
    l.add(0)
}

fun main() {
    val numere: MutableList<Number> = mutableListOf(1.5)
    adaugaZero(numere)
    println(numere)
}

in Int înseamnă „o listă în care pot pune Int-uri”: merge pentru MutableList<Int>, MutableList<Number> sau MutableList<Any>.

2Variabilă declarată cu out din greșeală

Greșit
KOTLIN
fun main() {
    val note: MutableList<out Number> = mutableListOf(9, 10)
    note.add(8)
}
Corect
KOTLIN
fun main() {
    val note: MutableList<Number> = mutableListOf(9, 10)
    note.add(8)
    println(note)
}

Fără out, lista e invariantă și acceptă orice Number la scriere.

Repară tu

Repară eroarea, direct în pagină

Funcția de mai jos adaugă o notă de bonus într-o listă, dar nu compilează: Receiver type 'MutableList<out Number>' contains out projection which prohibits the use of 'fun add(element: E): Boolean'. Repară tipul parametrului ca programul să afișeze [9, 7, 10].

Codul care dă eroarea
KOTLIN
fun adaugaBonus(note: MutableList<out Number>) {
    note.add(10)
}

fun main() {
    val note = mutableListOf(9, 7)
    adaugaBonus(note)
    println(note)
}
După reparație, programul afișează
[9, 7, 10]
Indiciu

Funcția doar scrie un Int în listă: parametrul poate fi MutableList<in Int> (sau MutableList<Int>).

Alte forme ale mesajului

  • error: receiver type 'MutableList<out Number>' contains out projection which prohibits the use of 'fun add(element: E): Boolean'.
  • Out-projected type 'MutableList<out Number>' prohibits the use of 'public abstract fun add(element: E): Boolean defined in kotlin.collections.MutableList'
  • Out-projected type 'MutableList<*>' prohibits the use of 'public abstract fun add(element: E): Boolean defined in kotlin.collections.MutableList'

Cum o eviți pe viitor

Regula „producer out, consumer in”: dacă funcția doar citește din colecție, folosește List<Number> (care e deja covariantă) sau out; dacă doar scrie, folosește in; dacă face ambele, folosește tipul exact (MutableList<Int>). Pentru parametrii care doar citesc, preferă interfața read-only List<T>, nu MutableList. Aceeași regulă se aplică la MutableList<*>: din ea nu poți adăuga nimic.

Întrebări frecvente

De ce List<Int> se poate da unde se cere List<Number>, dar MutableList<Int> nu?

List e declarată List<out E>: e doar pentru citire, deci e sigur. MutableList<E> permite și scrierea, deci nu poate fi covariantă fără restricții.

Ce înseamnă MutableList<*>?

O listă cu elemente de tip necunoscut. Poți citi elemente ca Any?, dar nu poți adăuga nimic, pentru că nu se știe ce tip ar fi acceptat.

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.