Unsupported escape sequence
Într-un string ai un backslash urmat de o literă pe care Kotlin nu o cunoaște ca secvență specială, de obicei într-o cale Windows ("C:\date"). Dublează backslash-ul ("C:\\date") sau folosește un raw string cu ghilimele triple ("""C:\date""").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În string-urile obișnuite (între ghilimele simple "..."), backslash-ul \ începe o secvență escape: \n (rând nou), \t (tab), \" (ghilimele), \\ (un backslash), \$ (semnul dolar), \u0041 (un caracter Unicode). Kotlin acceptă doar câteva: \t, \b, \n, \r, \', \", \\, \$ și \u.
Când scrii \d, \f, \s sau \., compilatorul nu știe ce caracter vrei și oprește compilarea cu Unsupported escape sequence. Coloana din mesaj arată exact backslash-ul problematic.
Cele mai frecvente locuri: căi de fișiere Windows ("C:\Users\ana") și expresii regulate ("\d+"), care au nevoie de backslash-uri reale. În Kotlin 1.x mesajul era Illegal escape: '\d'.
De ce apare: cauzele frecvente
1Cale Windows cu backslash simplu
fun main() {
val cale = "C:\date\raport.txt"
println(cale)
}fun main() {
val cale = "C:\\date\\raport.txt"
println(cale)
}\\ înseamnă un backslash literal. Alternativ, folosește /: Java acceptă și C:/date/raport.txt pe Windows.
2Expresie regulată într-un string obișnuit
fun main() {
val cifre = Regex("\d+")
println(cifre.find("cod 42")?.value)
}fun main() {
val cifre = Regex("""\d+""")
println(cifre.find("cod 42")?.value)
}Într-un raw string ("""...""") backslash-ul nu are sens special, deci \d ajunge neschimbat la motorul de regex.
Repară eroarea, direct în pagină
Programul de mai jos extrage anul dintr-o dată cu o expresie regulată, dar nu compilează: Unsupported escape sequence. Repară string-ul regex-ului (fără să schimbi expresia regulată) ca programul să afișeze Anul: 2024.
fun main() {
val data = "15.03.2024"
val an = Regex("\d{4}").find(data)?.value
println("Anul: $an")
}Anul: 2024
Indiciu
Pune regex-ul într-un raw string cu ghilimele triple sau dublează fiecare backslash.
Reparația
fun main() {
val data = "15.03.2024"
val an = Regex("""\d{4}""").find(data)?.value
println("Anul: $an")
}De ce merge
Într-un string obișnuit, \d ar fi o secvență escape, iar Kotlin nu are una cu litera d, deci compilarea se oprește. În raw string-ul """\d{4}""" backslash-ul rămâne un caracter normal, așa că motorul de regex primește exact \d{4} (patru cifre la rând). Varianta echivalentă este "\\d{4}".
Alte forme ale mesajului
error: unsupported escape sequence.Illegal escape: '\d'Illegal escape: '\s'
Cum o eviți pe viitor
Pentru regex-uri și căi de fișiere folosește din start raw strings: """\d{4}-\d{2}""". Pentru căi, preferă / sau File("date", "raport.txt"), care pune separatorul corect pe orice sistem. Când copiezi un regex dintr-un site sau din Java, verifică dacă e scris cu backslash-uri dublate ("\\d") și păstrează-l așa sau mută-l într-un raw string.
Întrebări frecvente
Cum pun un $ într-un raw string?
În raw string \$ nu funcționează, pentru că backslash-ul e literal. Scrie ${'$'}, de exemplu """Preț: ${'$'}10""". În Kotlin 2.2+ poți folosi și interpolarea cu mai mulți dolari ($$"""...""").
De ce \n merge, dar \d nu?
\n e în lista secvențelor cunoscute (rând nou). \d are sens doar pentru regex, nu pentru string-uri, deci compilatorul nu îl acceptă într-un string obișnuit.
Erori înrudite
Expecting ')' Compilatorul a ajuns la un punct în care aștepta o paranteză rotundă de închidere și n-a găsit-o. Aproape mereu ai uitat ) la un apel ca println(...) sau ai lăsat un string neînchis. Mergi la linia și coloana din mesaj și închide paranteza. Too many characters in a character literal Ai pus mai multe caractere între apostrofuri. În Kotlin 'a' este un singur Char, iar textul se scrie între ghilimele duble: "abc". Înlocuiește apostrofurile cu ghilimele. java.util.regex.PatternSyntaxException: Unclosed group near index 4 Expresia regulată din Regex(...) sau split/replace nu e validă: o paranteză deschisă fără pereche, un caracter special nescăpat (+, *, ?, ., (, [). Închide grupul sau scapă caracterul cu \\ (sau Regex.escape), ori folosește varianta cu text simplu: split(".") cu String, nu Regex. Î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.
