doc/tutorial/basics: added raw strings and regexps
Change-Id: Ibd86c718eaa4bb471b30c0b92cacb258dd12f714
Reviewed-on: https://cue-review.googlesource.com/c/1544
Reviewed-by: Marcel van Lohuizen <mpvl@google.com>
diff --git a/doc/tutorial/basics/stringraw.md b/doc/tutorial/basics/stringraw.md
new file mode 100644
index 0000000..6f5b73a
--- /dev/null
+++ b/doc/tutorial/basics/stringraw.md
@@ -0,0 +1,40 @@
+[TOC](Readme.md) [Prev](stringlit.md) [Next](bytes.md)
+
+_JSON Sugar and other Goodness_
+
+# "Raw" Strings
+
+CUE does not support raw strings in the strictest sense.
+Instead it allows modifying the escape delimiter by requiring
+an arbitrary number of hash `#` signs after the backslash by
+enclosing a string literal in an equal number of hash signs on either end.
+
+This works for normal and interpolated strings.
+Quotes do not have to be escaped in such strings.
+
+<!-- CUE editor -->
+```
+msg1: #"The sequence "\U0001F604" renders as \#U0001F604."#
+
+msg2: ##"""
+ A regular expression can conveniently be written as:
+
+ #"\d{3}"#
+
+ This construct works for bytes, strings and their multi-line variants.
+ """##
+```
+
+<!-- JSON result -->
+```json
+{
+ msg1: "The sequence \"\\U0001F604\" renders as 😄."
+ msg2: """
+ A regular expression can conveniently be written as:
+
+ #\"\\d{3}\"#
+
+ This construct works for bytes, strings and their multi-line variants.
+ """
+}
+```
