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

java.lang.IndexOutOfBoundsException: No group 4

Pe scurt

Textul de înlocuire dat lui Regex.replace (sau replaceAll) conține $ urmat de o cifră, pe care Java îl citește ca referință la un grup din regex ($1, $2). Grupul nu există. Escapează $ cu Regex.escapeReplacement(text) sau scrie \$, ori folosește replace cu lambda.

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

Ce înseamnă

La Regex.replace(text, inlocuire), textul de înlocuire nu este literal: $1, $2 înseamnă „conținutul grupului 1, 2 din regex”, iar \ escapează următorul caracter. Dacă înlocuirea conține un preț în dolari ($45) sau un $ urmat de cifră, Java caută grupul 4 (sau cât de mult se potrivește), nu-l găsește și aruncă IndexOutOfBoundsException: No group 4.

Dacă $ este ultimul caracter sau e urmat de o literă care nu formează un nume de grup, mesajul este IllegalArgumentException: Illegal group reference (de exemplu Illegal group reference: group index is missing).

Atenție: String.replace("vechi", "nou") (fără Regex) înlocuiește literal și nu are problema. Ea apare doar când primul argument este un Regex sau când folosești replaceAll / replaceFirst din Java.

De ce apare: cauzele frecvente

1Preț în dolari în textul de înlocuire

Greșit
KOTLIN
val t = sablon.replace(Regex("\\{pret\\}"), "$45")
Corect
KOTLIN
val t = sablon.replace(Regex("\\{pret\\}"), Regex.escapeReplacement("$45"))

escapeReplacement transformă $ și \ în caractere literale.

2Valoare dinamică pusă direct în înlocuire

Greșit
KOTLIN
val t = Regex("\\{nume\\}").replace(sablon, numeClient)
Corect
KOTLIN
val t = Regex("\\{nume\\}").replace(sablon) { numeClient }

Varianta cu lambda folosește rezultatul lambda-ului literal, fără să interpreteze $ sau \.

3Nu aveai nevoie de Regex

Greșit
KOTLIN
val t = sablon.replace(Regex("TOTAL"), "$100")
Corect
KOTLIN
val t = sablon.replace("TOTAL", "$100")

Pentru un text fix, String.replace(String, String) înlocuiește literal și e mai simplu.

Repară tu

Repară eroarea, direct în pagină

Programul completează un șablon de email cu prețul în dolari, dar $45 din textul de înlocuire e citit ca referință la grupul 4 și programul se oprește cu IndexOutOfBoundsException: No group 4. Repară înlocuirea (cu Regex.escapeReplacement) ca programul să afișeze Total de plata: $45.

Codul care dă eroarea
KOTLIN
fun main() {
    val sablon = "Total de plata: {suma}"
    val pret = "$45"
    println(sablon.replace(Regex("\\{suma\\}"), pret))
}
După reparație, programul afișează
Total de plata: $45
Indiciu

Trece textul de înlocuire prin Regex.escapeReplacement(...).

Alte forme ale mesajului

  • Exception in thread "main" java.lang.IndexOutOfBoundsException: No group 4
  • java.lang.IndexOutOfBoundsException: No group 1
  • java.lang.IllegalArgumentException: Illegal group reference: group index is missing
  • java.lang.IllegalArgumentException: Illegal group reference

Cum o eviți pe viitor

Când textul de înlocuire vine din date (nume, prețuri, căi de fișiere pe Windows cu \), nu-l da direct lui Regex.replace: folosește varianta cu lambda sau Regex.escapeReplacement. Folosește Regex doar când chiar ai un model; pentru text fix, String.replace e literal. Pentru referințe la grupuri, preferă grupuri cu nume ((?<an>\d{4}) și ${an}), mai ușor de citit.

Întrebări frecvente

De ce No group 4 și nu No group 45?

Java citește cifrele după $ cât timp formează un număr de grup valid pentru regex. Primul număr care nu există (aici 4) produce excepția.

Merge să scriu \$ în textul de înlocuire?

Da, \$ înseamnă un $ literal în înlocuire. În Kotlin, într-un string obișnuit, scrii "\\$45"; e mai clar cu Regex.escapeReplacement.

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.