Appendix. Characters, strings, and escaping rules 

This appendix covers the escaping rules used to represent non-ASCII characters in Haskell character and string literals. Haskell’s escaping rules follow the pattern established by the C programming language, but expand considerably upon them.

Writing character and string literals 

A single character is surrounded by ASCII single quotes, ', and has type Char.

ghci> 'c'
'c'
ghci> :type 'c'
'c' :: Char

A string literal is surrounded by double quotes, ", and has type [Char] (more often written as String).

ghci> "a string literal"
"a string literal"
ghci> :type "a string literal"
"a string literal" :: [Char]

The double-quoted form of a string literal is just syntactic sugar for list notation.

ghci> ['a', ' ', 's', 't', 'r', 'i', 'n', 'g'] == "a string"
True

International language support 

Haskell uses Unicode internally for its Char data type. Since String is just an alias for [Char], a list of Chars, Unicode is also used to represent strings.

Different Haskell implementations place limitations on the character sets they can accept in source files. GHC allows source files to be written in the UTF-8 encoding of Unicode, so in a source file, you can use UTF-8 literals inside a character or string constant. Do be aware that if you use UTF-8, other Haskell implementations may not be able to parse your source files.

When you run the ghci interpreter interactively, it may not be able to deal with international characters in character or string literals that you enter at the keyboard.

Although Haskell represents characters and strings internally using Unicode, there is no standardised way to do I/O on files that contain Unicode data. Haskell’s standard text I/O functions treat text as a sequence of 8-bit characters, and do not perform any character set conversion.

There exist third-party libraries that will convert between the many different encodings used in files and Haskell’s internal Unicode representation.

Escaping text 

Some characters must be escaped to be represented inside a character or string literal. For example, a double quote character inside a string literal must be escaped, or else it will be treated as the end of the string.

Single-character escape codes 

Haskell uses essentially the same single-character escapes as the C language and many other popular languages.

Single-character escape codes
Escape Unicode Character
\0 U+0000 null character
\a U+0007 backspace
\f U+000C form feed
\n U+000A newline (line feed)
\r U+000D carriage return
\t U+0009 horizontal tab
\v U+000B vertical tab
\" U+0022 double quote
\& n/a empty string
\' U+0027 single quote
\\ U+005C backslash

Multiline string literals 

To write a string literal that spans multiple lines, terminate one line with a backslash, and resume the string with another backslash. An arbitrary amount of whitespace (of any kind) can fill the gap between the two backslashes.

"this is a \
\long string,\
\ spanning multiple lines"

GHC 9.12 introduced a new MultilineStrings extension, which allows you to write the above as:

"""
this is a
long string,
spanning multiple lines
"""

ASCII control codes 

Haskell recognises the escaped use of the standard two- and three-letter abbreviations of ASCII control codes.

ASCII control code abbreviations
Escape Unicode Meaning
\NUL U+0000 null character
\SOH U+0001 start of heading
\STX U+0002 start of text
\ETX U+0003 end of text
\EOT U+0004 end of transmission
\ENQ U+0005 enquiry
\ACK U+0006 acknowledge
\BEL U+0007 bell
\BS U+0008 backspace
\HT U+0009 horizontal tab
\LF U+000A line feed (newline)
\VT U+000B vertical tab
\FF U+000C form feed
\CR U+000D carriage return
\SO U+000E shift out
\SI U+000F shift in
\DLE U+0010 data link escape
\DC1 U+0011 device control 1
\DC2 U+0012 device control 2
\DC3 U+0013 device control 3
\DC4 U+0014 device control 4
\NAK U+0015 negative acknowledge
\SYN U+0016 synchronous idle
\ETB U+0017 end of transmission block
\CAN U+0018 cancel
\EM U+0019 end of medium
\SUB U+001A substitute
\ESC U+001B escape
\FS U+001C file separator
\GS U+001D group separator
\RS U+001E record separator
\US U+001F unit separator
\SP U+0020 space
\DEL U+007F delete

Control-with-character escapes 

Haskell recognises an alternate notation for control characters, which represents the archaic effect of pressing the control key on a keyboard and chording it with another key. These sequences begin with the characters \^, followed by a symbol or uppercase letter.

Control-with-character escapes
Escape Unicode Meaning
\^@ U+0000 null character
\^A through \^Z U+0001 through U+001A control codes
\^[ U+001B escape
\^\ U+001C file separator
\^] U+001D group separator
\^^ U+001E record separator
\^_ U+001F unit separator

Numeric escapes 

Haskell allows Unicode characters to be written using numeric escapes. A decimal character begins with a digit, e.g. \1234. A hexadecimal character begins with an x, e.g. \xbeef. An octal character begins with an o, e.g. \o1234.

The maximum value of a numeric literal is \1114111, which may also be written \x10ffff or \o4177777.

The zero-width escape sequence 

String literals can contain a zero-width escape sequence, written \&. This is not a real character, as it represents the empty string.

ghci> "\&"
""
ghci> "foo\&bar"
"foobar"

The purpose of this escape sequence is to make it possible to write a numeric escape followed immediately by a regular ASCII digit.

ghci> "\130\&11"
"\130\&11"

Because the empty escape sequence represents an empty string, it is not legal in a character literal.