add chapter 2

Author: chenzc

2-GettingStarted/2.1-Basic_Syntax.md

@@ -1 +1,340 @@
-# 基础语法
+# 基础语法
+
+**定义包**
+
+定义包应该在源文件的最顶部。
+
+```
+package my.demo
+
+import java.util.*
+
+// ...
+```
+
+包名不需要和文件夹路径保持一致：源文件可以摆放在文件系统中的任意位置。
+
+查看[详情](../3-Basics/3.2-Packages.md)。
+
+**定义函数**
+
+包含2个`Int`类型的参数，并返回`Int`类型值的函数：
+
+```
+fun sum(a: Int, b: Int): Int {
+    return a + b
+}
+```
+
+包含表达式表示返回值类型的函数：
+
+```
+fun sum(a: Int, b: Int) = a + b
+```
+
+返回无意义返回值的函数：
+
+```
+fun printSum(a: Int, b: Int): Unit {
+    println("sum of $a and $b is ${a + b}")
+}
+```
+
+省略掉`Unit`类型返回值的函数：
+
+```
+fun printSum(a: Int, b: Int) {
+    println("sum of $a and $b is ${a + b}")
+}
+```
+
+查看[详情](../5-FunctionsAndLambdas/5.1-Functions.md)。
+
+**定义局部变量**
+
+只赋值一次的（只读的）局部变量：
+
+```
+val a: Int = 1  // 马上赋值
+val b = 2   // 默认表示Int类型
+val c: Int  // 当没有初始化时，变量需指定类型
+c = 3       // 延时赋值
+```
+
+可变变量：
+
+```
+var x = 5 // 代表了Int类型
+x += 1
+```
+
+查看[详情](../4-ClassesAndObjects/4.2-Properties_and_Fields.md)。
+
+**注释**
+
+跟Java和JavaScript类似，Kotlin也支持单行注释和块注释。
+
+```
+// This is an end-of-line comment
+
+/* This is a block comment
+   on multiple lines. */
+```
+
+与Java不一样的是，在Kotlin中块注释可以互相嵌套。
+
+查看[生成Kotlin代码文档](../10-Tools/10.1-Documenting_Kotlin_Code.md)去获得关于文档化注释语法的信息。
+
+**使用字符串模板**
+
+```
+var a = 1
+// 在模板中的变量名：
+val s1 = "a is $a" 
+
+a = 2
+// 在模板中的任意表达式:
+val s2 = "${s1.replace("is", "was")}, but now is $a"
+```
+
+[TODO]: 跳转到基本类型的字符串模板
+查看[详情](../3-Basics/3.1-Basic_Types.md)。
+
+**使用条件表达式**
+
+```
+fun maxOf(a: Int, b: Int): Int {
+    if (a > b) {
+        return a
+    } else {
+        return b
+    }
+}
+```
+
+使用`If`表达式：
+
+```
+fun maxOf(a: Int, b: Int) = if (a > b) a else b
+```
+
+[TODO]: 跳转到控制流中的if表达式
+查看[详情](../3-Basics/3.3-Control_Flow.md)。
+
+**使用可为null的值和检查null**
+
+一个引用可能为null值时，必须要明确表达为可能为null。
+如果`str`不能转换成一个整型数字，则返回null：
+
+```
+fun parseInt(str: String): Int? {
+    // ...
+}
+```
+
+使用一个可能返回null值的函数：
+
+```
+fun printProduct(arg1: String, arg2: String) {
+    val x = parseInt(arg1)
+    val y = parseInt(arg2)
+
+    // 在执行x * y时可能出错，是因为他们可能为null。
+    if (x != null && y != null) {
+        // 在经过非空检查后，x和y自动转换成非空的
+        println(x * y)
+    }
+    else {
+        println("either '$arg1' or '$arg2' is not a number")
+    }    
+}
+```
+
+或者
+
+```
+// ...
+if (x == null) {
+    println("Wrong number format in arg1: '${arg1}'")
+    return
+}
+if (y == null) {
+    println("Wrong number format in arg2: '${arg2}'")
+    return
+}
+
+// 在经过非空检查后，x和y自动转换成非空的
+println(x * y)
+```
+
+查看[详情](../6-Others/6.8-Null_Safety.md)。
+
+**使用类型检查和自动转换**
+
+`is`操作符检查一个表达式是否是一个类型的实例。如果一个可变的局部变量或者属性检查是否为指定类型时，很明确没有必要去转换：
+
+```
+fun getStringLength(obj: Any): Int? {
+    if (obj is String) {
+        // 在这个分支下，obj自动转换成String
+        return obj.length
+    }
+
+    // 在判断分支外，obj仍然是Any类型
+    return null
+}
+```
+
+或者
+
+```
+fun getStringLength(obj: Any): Int? {
+    if (obj !is String) return null
+
+    // 在这个分支下，obj自动转换成String
+    return obj.length
+}
+```
+
+甚至
+
+```
+fun getStringLength(obj: Any): Int? {
+    // 在&&操作符右侧，obj自动转换成String
+    if (obj is String && obj.length > 0) {
+        return obj.length
+    }
+
+    return null
+}
+```
+
+查看[类](../4-ClassesAndObjects/4.1-Classes_and_Inheritance.md)和[类型转换](../6-Others/6.4-Type_Checks_and_Casts.md)。
+
+**使用for循环**
+
+```
+val items = listOf("apple", "banana", "kiwi")
+for (item in items) {
+    println(item)
+}
+```
+
+或者
+
+```
+val items = listOf("apple", "banana", "kiwi")
+for (index in items.indices) {
+    println("item at $index is ${items[index]}")
+}
+```
+
+[TODO]: 跳转到控制流中的for循环
+查看[详情](../3-Basics/3.3-Control_Flow.md)。
+
+**使用while循环**
+
+```
+val items = listOf("apple", "banana", "kiwi")
+var index = 0
+while (index < items.size) {
+    println("item at $index is ${items[index]}")
+    index++
+}
+```
+
+[TODO]: 跳转到控制流中的while循环
+查看[详情](../3-Basics/3.3-Control_Flow.md)。
+
+**使用when表达式**
+
+```
+fun describe(obj: Any): String =
+when (obj) {
+    1          -> "One"
+    "Hello"    -> "Greeting"
+    is Long    -> "Long"
+    !is String -> "Not a string"
+    else       -> "Unknown"
+}
+```
+
+[TODO]: 跳转到控制流中的when表达式
+查看[详情](../3-Basics/3.3-Control_Flow.md)。
+
+**使用区间**
+
+使用`in`操作符检查数值是否在已知区间内。
+
+```
+val x = 10
+val y = 9
+if (x in 1..y+1) {
+    println("fits in range")
+}
+```
+
+检查数值不在已知区间内。
+
+```
+val list = listOf("a", "b", "c")
+
+if (-1 !in 0..list.lastIndex) {
+    println("-1 is out of range")
+}
+if (list.size !in list.indices) {
+    println("list size is out of valid list indices range too")
+}
+```
+
+迭代已知区间内的元素：
+
+```
+for (x in 1..5) {
+    print(x)
+}
+```
+
+或者通过指定的步长进行迭代：
+
+```
+for (x in 1..10 step 2) {
+    print(x)
+}
+for (x in 9 downTo 0 step 3) {
+    print(x)
+}
+```
+
+查看[详情](../6-Others/6.3-Ranges.md)。
+
+**使用集合**
+
+对集合进行迭代：
+
+```
+for (item in items) {
+    println(item)
+}
+```
+
+使用`in`操作符检查集合中是否包含某个对象：
+
+```
+when {
+    "orange" in items -> println("juicy")
+    "apple" in items -> println("apple is fine too")
+}
+```
+
+使用lambda表达式过滤和映射操作集合：
+
+```
+fruits
+.filter { it.startsWith("a") }
+.sortedBy { it }
+.map { it.toUpperCase() }
+.forEach { println(it) }
+```
+
+查看[详情](../5-FunctionsAndLambdas/5.2-Higher-Order_Functions_and_Lambdas.md)。