add text blocks

Author: forax

chapter01-basic_types.jsh

@@ -58,8 +58,27 @@ System.out.println(intValue);
 // that are object but considered as built-in by the compiler
 
 // ### String
-// String that stores a text (a sequence of characters)
+// A String that stores a text (a sequence of characters) is delimited
+// by two doublequotes
 var text = "hello"; 
+System.out.println(text);
+
+// a String can also span several lines, it's called a __text block__
+// and starts and ends with 3 double quotes
+var multilineText = """
+   This is
+   a multilines string
+   """;
+System.out.println(multilineText);
+
+// The indentation is determined by the alignment compared to position of the last """
+// By example, to have an indentation of two spaces
+var multilineText = """
+     This is
+     a multilines string
+     indented by two spaces
+   """;
+System.out.println(multilineText);
 
 // Strings have a lot of methods, here is some of them
 // length of a String
@@ -69,6 +88,9 @@ System.out.println("hello".length());
 System.out.println("hello".toUpperCase());
 System.out.println("hello".toLowerCase());
 
+// repeat the same pattern
+System.out.println("|*|".repeat(3));
+
 // char at an index (starting with index 0)
 System.out.println("hello".charAt(0));
 

guide/chapter01-basic_types.md

@@ -72,9 +72,32 @@ All other types are objects, there are two special types, String and arrays
 that are object but considered as built-in by the compiler
 
 ### String
-String that stores a text (a sequence of characters)
+A String that stores a text (a sequence of characters) is delimited
+by two doublequotes
 ```java
 var text = "hello"; 
+System.out.println(text);
+```
+
+a String can also span several lines, it's called a __text block__
+and starts and ends with 3 double quotes
+```java
+var multilineText = """
+   This is
+   a multilines string
+   """;
+System.out.println(multilineText);
+```
+
+The indentation is determined by the alignment compared to position of the last """
+By example, to have an indentation of two spaces
+```java
+var multilineText = """
+     This is
+     a multilines string
+     indented by two spaces
+   """;
+System.out.println(multilineText);
 ```
 
 Strings have a lot of methods, here is some of them
@@ -89,6 +112,11 @@ System.out.println("hello".toUpperCase());
 System.out.println("hello".toLowerCase());
 ```
 
+repeat the same pattern
+```java
+System.out.println("|*|".repeat(3));
+```
+
 char at an index (starting with index 0)
 ```java
 System.out.println("hello".charAt(0));

jupyter/chapter01-basic_types.ipynb

@@ -146,15 +146,43 @@
 {
   "cell_type": "markdown",
   "metadata": {},
-  "source": ["### String\n", "String that stores a text (a sequence of characters)\n"]
+  "source": ["### String\n", "A String that stores a text (a sequence of characters) is delimited\n", "by two doublequotes\n"]
 }
 ,
 {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
-  "source": ["var text = \"hello\"; \n"]
+  "source": ["var text = \"hello\"; \n", "System.out.println(text);\n"]
+}
+,
+{
+  "cell_type": "markdown",
+  "metadata": {},
+  "source": ["a String can also span several lines, it's called a __text block__\n", "and starts and ends with 3 double quotes\n"]
+}
+,
+{
+  "cell_type": "code",
+  "execution_count": null,
+  "metadata": {},
+  "outputs": [],
+  "source": ["var multilineText = \"\"\"\n", "   This is\n", "   a multilines string\n", "   \"\"\";\n", "System.out.println(multilineText);\n"]
+}
+,
+{
+  "cell_type": "markdown",
+  "metadata": {},
+  "source": ["The indentation is determined by the alignment compared to position of the last \"\"\"\n", "By example, to have an indentation of two spaces\n"]
+}
+,
+{
+  "cell_type": "code",
+  "execution_count": null,
+  "metadata": {},
+  "outputs": [],
+  "source": ["var multilineText = \"\"\"\n", "     This is\n", "     a multilines string\n", "     indented by two spaces\n", "   \"\"\";\n", "System.out.println(multilineText);\n"]
 }
 ,
 {
@@ -185,6 +213,20 @@
   "source": ["System.out.println(\"hello\".toUpperCase());\n", "System.out.println(\"hello\".toLowerCase());\n"]
 }
 ,
+{
+  "cell_type": "markdown",
+  "metadata": {},
+  "source": ["repeat the same pattern\n"]
+}
+,
+{
+  "cell_type": "code",
+  "execution_count": null,
+  "metadata": {},
+  "outputs": [],
+  "source": ["System.out.println(\"|*|\".repeat(3));\n"]
+}
+,
 {
   "cell_type": "markdown",
   "metadata": {},