...
Eroare Kotlin · when, if și funcții

Illegal usage of inline parameter 'block: () -> Unit'. Add 'noinline' modifier to the parameter declaration

Pe scurt

Într-o funcție inline, folosești lambda primită ca pe o valoare: o pui într-o listă, o salvezi într-o proprietate sau o dai unei funcții care nu e inline. Lambda inline nu există ca obiect. Marchează parametrul cu noinline sau scoate inline de pe funcție.

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

Ce înseamnă

La o funcție inline, compilatorul copiază atât corpul funcției, cât și codul lambdelor primite direct în locul apelului. Lambda nu mai devine un obiect, deci nu are referință pe care s-o păstrezi. Poți doar s-o apelezi (block()) sau s-o dai mai departe unei alte funcții inline.

Dacă încerci s-o tratezi ca valoare (lista.add(block), this.callback = block, executor.submit(block), val f = block), compilatorul spune Illegal usage of inline parameter 'block'. Add 'noinline' modifier to the parameter declaration.

noinline cere ca acel parametru să fie transmis ca obiect obișnuit, iar ceilalți parametri lambda rămân inline. Dacă funcția are o singură lambda și aceasta e noinline, cuvântul inline de pe funcție nu mai aduce aproape nimic: poți să-l ștergi.

De ce apare: cauzele frecvente

1Lambda salvată într-o listă

Greșit
KOTLIN
val actiuni = mutableListOf<() -> Unit>()
inline fun inregistreaza(block: () -> Unit) { actiuni.add(block) }
Corect
KOTLIN
val actiuni = mutableListOf<() -> Unit>()
fun inregistreaza(block: () -> Unit) { actiuni.add(block) }

Ca s-o păstrezi, lambda trebuie să fie obiect; o funcție obișnuită primește exact un obiect.

2Lambda dată unei funcții care nu e inline

Greșit
KOTLIN
inline fun programeaza(block: () -> Unit) {
    java.util.concurrent.Executors.newSingleThreadExecutor().execute(block)
}
Corect
KOTLIN
inline fun programeaza(noinline block: () -> Unit) {
    java.util.concurrent.Executors.newSingleThreadExecutor().execute(block)
}

execute primește un obiect, deci parametrul trebuie să fie noinline.

3Două lambde, doar una stocată

Greșit
KOTLIN
inline fun ecran(onStart: () -> Unit, onClick: () -> Unit) {
    onStart()
    handler = onClick
}
Corect
KOTLIN
inline fun ecran(onStart: () -> Unit, noinline onClick: () -> Unit) {
    onStart()
    handler = onClick
}

noinline doar pe lambda stocată; onStart rămâne inline.

Repară tu

Repară eroarea, direct în pagină

Funcția inline inregistreaza adaugă lambda primită într-o listă de acțiuni, iar compilarea se oprește cu Illegal usage of inline parameter 'block'. Marchează parametrul ca să poată fi stocat, astfel încât programul să afișeze salvez și trimit (pe două rânduri).

Codul care dă eroarea
KOTLIN
val actiuni = mutableListOf<() -> Unit>()

inline fun inregistreaza(block: () -> Unit) {
    actiuni.add(block)
}

fun main() {
    inregistreaza { println("salvez") }
    inregistreaza { println("trimit") }
    actiuni.forEach { it() }
}
După reparație, programul afișează
salvez
trimit
Indiciu

Modificatorul care transmite lambda ca obiect obișnuit este noinline.

Alte forme ale mesajului

  • error: illegal usage of inline parameter 'block: () -> Unit'. Add 'noinline' modifier to the parameter declaration.
  • Illegal usage of inline-parameter 'block' in 'public inline fun inregistreaza(block: () -> Unit): Unit defined in root package'. Add 'noinline' modifier to the parameter declaration

Cum o eviți pe viitor

Pune inline doar pe funcții care apelează lambda imediat. Dacă lambda trebuie păstrată, trimisă pe alt fir sau dată unei funcții Java, folosește o funcție obișnuită sau marchează parametrul noinline. IntelliJ arată un avertisment când inline nu aduce beneficii: ia-l în serios.

Întrebări frecvente

De ce există funcții inline?

Ca să evite crearea unui obiect pentru fiecare lambda și să permită return non-local și reified. De aceea forEach, map, let sunt inline.

Pierd ceva dacă scot inline?

Pentru o funcție cu o lambda pe care o stochezi, practic nimic: lambda trebuia oricum să devină obiect. Pierzi doar return non-local din lambda și reified, dacă le foloseai.

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.