Kotlin/基础语法

维基教科书,自由的教学读本

基础语法[编辑]

以下列举出需要知道的基础语法,深度的剖析会在之后逐步说明

Package 和 import[编辑]

package my.demo

import kotlin.text.*

// ...

这里的宣告不一定要完全的合乎资料夹结构,你可以在专案里任意选择放置程式码的位置

程式进入点[编辑]

程式进入点是 main() 函式

fun main() {
    println("Hello world!")
}

注意程式码结尾不需要加上分号(;)

函式[编辑]

宣告函式的关键字是 fun

宣告一个收两个 Int,并回传一个 Int的函式

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

只包含 body,隐含回传型态的写法

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


变数[编辑]

只可读取的常数(value)以 val 宣告,这些常数只能被赋值一次

val a: Int = 1  // 立刻賦值
val b = 2   // 省略 `Int` 型態宣告
val c: Int  // 沒有立刻賦值的話,一定要宣告型態
c = 3       // 延後賦值

可重复赋值的变数(variable)以 var 宣告

var x = 5 // 省略 `Int` 型態宣告
x += 1

Top-level 变数

val PI = 3.14
var x = 0

fun incrementX() { 
    x += 1 
}

注解[编辑]

跟多数语言一样,Kotlin 支援单行和多行注解

// 這是單行註解

/* 這是一個
多行註解 */

另外也支持巢状注解

/* The comment starts here
/* contains a nested comment */     
and ends here. */

字串样板[编辑]

var a = 1
// 樣板內使用變數名稱
val s1 = "a is $a" 

a = 2
// 樣板內使用變數和函式
val s2 = "${s1.replace("is", "was")}, but now is $a"

条件式[编辑]

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

Kotlin 内可以将 if 当作表达式来使用

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


Nullable 和 null 检查[编辑]

Kotlin 内预设是不允许接收 null 的。如果希望可以接收或者回传 null 的话,要特别加上“?”标记

比方说,如果 str 不包含数字的话,希望回传 null 的写法:

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

使用可能回传 null 的函式,Kotlin 会自动进行检查

fun printProduct(arg1: String, arg2: String) {
    val x = parseInt(arg1)
    val y = parseInt(arg2)

    // 如果不進行檢查就嘗試 `x * y`,因為這兩個變數可能是 null,所以會直接拋出錯誤
    if (x != null && y != null) {
        // x 和 y 經過檢查之後,被標記為非 nullable,所以不會直接拋出錯誤
        println(x * y)
    }
    else {
        println("'$arg1' 或 '$arg2' 不是數字")
    }    
}


或者可以这样写

// ...
if (x == null) {
    println("arg1 格式不對:'$arg1'")
    return
}
if (y == null) {
    println("arg2 格式不對:'$arg2'")
    return
}

// x 和 y 經過檢查之後,被標記為非 nullable,所以不會直接拋出錯誤
println(x * y)

型态检查和自动转型[编辑]

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
}

for[编辑]

val items = listOf("apple", "banana", "kiwifruit")
for (item in items) {
    println(item)
}

或者

val items = listOf("apple", "banana", "kiwifruit")
for (index in items.indices) {
    println("item at $index is ${items[index]}")
}

while[编辑]

val items = listOf("apple", "banana", "kiwifruit")
var index = 0
while (index < items.size) {
    println("item at $index is ${items[index]}")
    index++
}

when[编辑]

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

范围(Range)[编辑]

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)
}
println()
for (x in 9 downTo 0 step 3) {
    print(x)
}

集合[编辑]

在集合里做迭代:

for (item in items) {
    println(item)
}

in 判断某物件是否在集合里面:

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

用 lambda 表达式来过滤并重组集合:

val fruits = listOf("banana", "avocado", "apple", "kiwifruit")
fruits
  .filter { it.startsWith("a") }
  .sortedBy { it }
  .map { it.toUpperCase() }
  .forEach { println(it) }

建立基本物件和变数[编辑]

val rectangle = Rectangle(5.0, 2.0)
val triangle = Triangle(3.0, 4.0, 5.0)