E07903: a unicode escape needs exactly four hex digits (0-9, a-f, A-F) - write \\u for a backslash and a 'u'
What went wrong
A backslash-u in a String is not followed by exactly four hex digits. In a String, a backslash then 'u' starts a unicode escape, which needs four hex digits (0-9, a-f, A-F): "\u00e9" is an e with an acute accent. Anything else - a sign ("\u+041"), too few digits ("\u004"), a non-ASCII digit, or simply text such as the 'u' in a Windows path ("C:\users") - is not an escape. It used to be decoded loosely: "\u+041" became 'A' and "\u-001" became U+FFFF.
Worked examples
Compilable examples demonstrating this error and the correct fix:
- ek9 -q 1394 (Why must a constant's String be written with double quotes?)
How to fix it
For a unicode character, give exactly four hex digits:
- "A\u+041B" --> "A\u0041B"
For a backslash followed by a 'u', escape the backslash:
- "C:\users\steve" --> "C:\\users\\steve"
Common causes
- A Windows path written with single backslashes
- An escape copied with a missing or extra digit
- A sign or space inside the escape
See also
- E07902: a compile-time String must be a plain "..." literal
- https://ek9.io/builtInTypes.html#string_literals
Examples
Every example is compiled by the EK9 compiler: the first fails exactly as captioned, the others fix it.
Fails with E07903: a unicode escape needs exactly four hex digits (0-9, a-f, A-F) - write \\u for a backslash and a 'u'
#!ek9 defines module error.e07903.bad defines function escapes() <- rtn as String? signed <- "A\u+041B" negative <- "C\u-001D" tooShort <- "T\u004" inBacktick <- `L\u+041M` //An escaped backslash then a 'u' is two plain characters, and a real escape is still fine. windowsPath <- "C:\\users\\steve" letter <- "\u0041" rtn: signed + negative + tooShort + inBacktick + windowsPath + letter
Fixed: Escape the backslash, or give four hex digits
#!ek9 defines module error.e07903.good defines function //Escape the backslash... home() <- rtn as String: "C:\\users\\steve" //...or give exactly four hex digits accented() <- rtn as String: "caf\u00e9"
Questions and answers
These Q&A entries show E07903 and its fix:
Found a problem?
If EK9 reported E07903 for a program you think is valid, or did not report it where it should have, use the compiler form with the smallest program that shows it. If this page is wrong or unclear, use the documentation form. Both are at github.com/ek9lang/ek9-issues.