文档结构  
翻译进度:已翻译     翻译赏金:0 元 (?)    ¥ 我要打赏

包定义

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

package my.demo

import 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

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

第 1 段(可获 0.94 积分)
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

第 2 段(可获 0.51 积分)

可变的变量:

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:
第 3 段(可获 0.64 积分)
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 不包含一个整数:

第 4 段(可获 0.85 积分)
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}'")
第 5 段(可获 0.2 积分)
    return
}
// x and y are automatically cast to non-nullable after null check
println(x * y)

目标平台: JVMRunning on kotlin v. 1.1.2

请看 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
第 6 段(可获 0.64 积分)
    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")
第 7 段(可获 0.48 积分)
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 = 0
while (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"
第 8 段(可获 0.49 积分)
    "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 = 10
val y = 9
if (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")
第 9 段(可获 0.53 积分)
}

目标平台: 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.

第 10 段(可获 1.16 积分)

文章评论

CY2
没觉得这个语法有多清爽。。。。
成都访客
觉得语法和swift 有点像喃?
班纳睿
kotlin最近很火啊,我明天上班也要研究下看看了