网页链接：https://kotlinlang.org/docs/reference/basic-syntax.html

1.   入门

1.1.  基本语法

1.1.1.   定义包

包说明应该在源文件的顶部：

package my.demo
import java.util.*
// …

并不要求包与目录匹配：源文件可以在文件系统中的任意地方。

查看：包（2.2）

1.1.2.   定义函数

函数带有Int类型参数，并返回Int类型值：

fun sum(a: Int, b: Int): Int {
    return a+b
}

函数体可以是表达式，并可从中推断出返回值类型：

fun sum(a: Int, b: Int) = a + b

函数可返回无意义的值：

fun pringSum(a: Int, b: Int): Unit {
    print(a + b)
}

Unit 返回值类型可以省略：

public fun printSum(a: Int, b: Int) {
    print(a + b)
}

查看：函数（4.1）

1.1.3.   定义局部变量

一次赋值（只读）局部变量：

 

val a: Int = 1
val b: = 1    // 推测为Int 类型
val c: Int    // 没有初始化就要求说明类型
c = 1         // 明确赋值

可变变量：

var x = 5    // 推测为Int类型
x += 1

查看：属性和域（3.2）

1.1.4.   使用字符串模板

 

fun main(args: Array<String>) {
    if (args.size == 0) return

    print(“First argument: ${args[0]}”)
}

查看：串模板（2.1.5.2）

1.1.5.   使用条件表达式

fun max(a: Int, b: Int): Int {
    if (a > b)
        return a
    else
        return b
}  

使用if表达式：

fun max(a: Int, b: Int) = if (a > b) a else b

查看：if表达式（2.3.1）

1.1.6.   使用nullable值检测空（null）值

当null值可能出现时，引用必须明确标记出可null值。

如果str没有保存一整数，则返回 null：

fun parseInt(str: String): Int? {
    // …
}

用函数返回可null值：

 

fun main(args: Array<String>) {
  if (args.size < 2) {
    print("Two integers expected")
    return
  }

  val x = parseInt(args[0])
  val y = parseInt(args[1])

  // 由于x、y是null，所以使用 x * y 将产生错误。
  if (x != null && y != null) {
    // 在null检查后，x 和 y 自动地配置（cast）到非可null
    print(x * y)
  }
}

或

// ...
if (x == null) {
    print("Wrong number format in '${args[0]}'")
    return
}
if (y == null) {
    print("Wrong number format in '${args[1]}'")
    return
}

// 在null检查后，x 和 y 自动地配置（cast）到非可nul
print(x * y)

查看：Null安全（5.7）

1.1.7.   使用类型检查和自动类型转换

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
}

查看：类（3.1.1）和类型转换（5.3）

1.1.8.   使用for循环

fun main(args: Array<String>) {
  for (arg in args)
    print(arg)
}

或

for (i in args.indices)
  print(args[i])

查看：for循环（2.3.3）

1.1.9.   使用while循环

fun main(args: Array<String>) {
  var i = 0
  while (i < args.size)
    print(args[i++])
}

查看：while循环（2.3.4）

1.1.10.   使用when表达式

fun cases(obj: Any) {
  when (obj) {
    1          -> print("One")
    "Hello"    -> print("Greeting")
    is Long    -> print("Long")
    !is String -> print("Not a string")
    else       -> print("Unknown")
  }
}

查看：when表达式（2.3.2）

1.1.11.   使用range（范围）

使用in操作符检查一个数字是否在一个范围内：

if (x in 1..y-1)
  print("OK")

检查一个数字是否超出范围：

if (x !in 0..array.lastIndex)
  print("Out")

遍历