【技术】Kotlin 编程语言的基本语法

包的声明必须在源码文件的最顶部：

package my.demoimport java.util.*// ...

跟 Java 不同，Kotlin 的包不一定非要对应文件目录，可以放在任何地方。

详情请看 Packages.

函数定义

定义一个包含两个 Int 参数，以及返回 Int 类型的函数：

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

}

目标平台: JVM on kotlin v. 1.1.2

定义一个表达式函数体以及推断返回类型的函数：

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

目标平台: JVM on kotlin v. 1.1.2

定义返回没有意义值的函数：

fun printSum(a: Int, b: Int): Unit {

    println("sum of $a and $b is ${a + b}")

}

目标平台: JVM on kotlin v. 1.1.2

Unit 返回类型可以被忽略：

fun printSum(a: Int, b: Int) {

    println("sum of $a and $b is ${a + b}")

}

目标平台: JVM on kotlin v. 1.1.2

详情请看 Functions.

定义局部变量

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

val a: Int = 1  // 立即赋值val b = 2   // `Int` 类型是根据推断而来val c: Int  // 当没有提供初始化时就要求指定类型c = 3       // 推迟赋值

目标平台: JVM on kotlin v. 1.1.2

var x = 5 // `Int` 类型是根据推断而来x += 1

目标平台: JVM on kotlin v. 1.1.2

请看 Properties And Fields.

注释

和 Java 和 JavaScript 代码一样，Kotlin 支持单行注释和块注释

// This is an end-of-line comment/* This is a block comment
   on multiple lines. */

和 Java 不同，Kotlin 的块注释允许嵌套。

请看 Documenting Kotlin Code 来了解更多文档注释语法。

使用字符串模板

var a = 1

// simple name in template:

val s1 = "a is $a"

a = 2
// arbitrary expression in template:

val s2 = "${s1.replace("is", "was")}, but now is $a"

目标平台: JVM on kotlin v. 1.1.2

请看 String templates.

使用条件表达式

fun maxOf(a: Int, b: Int): Int {    if (a > b) {        return a

    } else {        return b

    }

}

目标平台: JVM on kotlin v. 1.1.2

使用 if 作为表达式：

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

目标平台: JVM on kotlin v. 1.1.2

请看 if-expressions.

使用允许为空的值以及检测空值

当允许 null 值时，一个引用必须明确的标注允许为空。

返回 null 如果 str 不包含一个整数：

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

使用函数返回允许为空的值：

fun printProduct(arg1: String, arg2: String) {

    val x = parseInt(arg1)

    val y = parseInt(arg2)



    // Using `x * y` yields error because they may hold nulls.    if (x != null && y != null) {        // x and y are automatically cast to non-nullable after null check

        println(x * y)

    }    else {

        println("either '$arg1' or '$arg2' is not a number")

    }    

}

目标平台: JVMRunning on kotlin v. 1.1.2

或者

// ...

if (x == null) {

println("Wrong number format in arg1: '${arg1}'")

return

}

if (y == null) {

println("Wrong number format in arg2: '${arg2}'")

return

}

// x and y are automatically cast to non-nullable after null check

println(x * y)

请看 Null-safety.

使用类型检查以及自动类型转换

is 操作符检查一个表达式是否是某个类型的实例。如果检查一个不可变的局部变量或者属性是否是某个特定类型，就不需要显式的进行转换：

fun getStringLength(obj: Any): Int? {

if (obj is String) {

// `obj` is automatically cast to `String` in this branch

return obj.length

}

// `obj` is still of type `Any` outside of the type-checked branch


return null

}

目标平台: JVMRunning on kotlin v. 1.1.2

fun getStringLength(obj: Any): Int? {    if (obj !is String) return null

    // `obj` is automatically cast to `String` in this branch    return obj.length

}

目标平台: JVMRunning on kotlin v. 1.1.2

甚至

fun getStringLength(obj: Any): Int? {    // `obj` is automatically cast to `String` on the right-hand side of `&&`    if (obj is String && obj.length > 0) {        return obj.length

    }    return null}

目标平台: JVMRunning on kotlin v. 1.1.2

请看 Classes 和 Type casts.

使用 for 循环

val items = listOf("apple", "banana", "kiwi")

for (item in items) {

println(item)

}

目标平台: JVMRunning on kotlin v. 1.1.2

或者

val items = listOf("apple", "banana", "kiwi")for (index in items.indices) {

    println("item at $index is ${items[index]}")

}

目标平台: JVMRunning on kotlin v. 1.1.2

请看 for loop.

使用 while 循环

val items = listOf("apple", "banana", "kiwi")var index = 0while (index items.size) {

    println("item at $index is ${items[index]}")    index++

}

目标平台: JVMRunning on kotlin v. 1.1.2

请看 while loop.

使用 when 表达式

fun describe(obj: Any): String =

when (obj) {

1 -> "One"

"Hello" -> "Greeting"

is Long -> "Long"

!is String -> "Not a string"

else -> "Unknown"

}

目标平台: JVMRunning on kotlin v. 1.1.2

请看 when expression.

使用 ranges 范围

检查一个数值是否在某个范围内，可以用 in 操作符：

val x = 10val y = 9if (x in 1..y+1) {

    println("fits in range")

}

目标平台: JVMRunning on kotlin v. 1.1.2

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

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")

}

目标平台: JVMRunning on kotlin v. 1.1.2

对范围进行迭代：

for (x in 1..5) {

    print(x)

}

目标平台: JVMRunning on kotlin v. 1.1.2

对一个进度进行迭代：

for (x in 1..10 step 2) {

    print(x)

}for (x in 9 downTo 0 step 3) {

    print(x)

}

目标平台: JVMRunning on kotlin v. 1.1.2

请看 Ranges.

使用集合

对集合进行迭代

for (item in items) {

    println(item)

}

目标平台: JVMRunning on kotlin v. 1.1.2

使用 in 操作符检查一个集合中是否包含某个对象

when {    "orange" in items -> println("juicy")    "apple" in items -> println("apple is fine too")

}

目标平台: JVMRunning on kotlin v. 1.1.2

使用 lambda 表达式对集合进行过滤和映射

fruits.filter { it.startsWith("a") }.sortedBy { it }.map { it.toUpperCase() }

.forEach { println(it) }

目标平台: JVMRunning on kotlin v. 1.1.2

请看 Higher-order functions and Lambdas.