包声明

代码文件的开头一般为包的声明:

  1. package com.demo.main
  2. import java.util.*
  3. fun test() {}
  4. class Person {}

kotlin源文件不需要相匹配的目录和包,源文件可以放在任何文件目录
以上例中

  • test() 的全名是 com.demo.main.test、
  • Person 的全名是 com.demo.main.Person

如果没有指定包,默认为 default 包。

默认导入

有多个包会默认导入到每个 Kotlin 文件中:

  1. kotlin.*
  2. kotlin.annotation.*
  3. kotlin.collections.*
  4. kotlin.comparisons.*
  5. kotlin.io.*
  6. kotlin.ranges.*
  7. kotlin.sequences.*
  8. kotlin.text.*

函数定义

函数定义使用关键字 fun,参数格式为:参数 : 类型

  1. fun sum(a: Int, b: Int): Int { // Int 参数,返回值 Int
  2. return a + b
  3. }

表达式作为函数体,返回类型自动推断:

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

public fun sum(a: Int, b: Int): Int = a + b   // public 方法则必须明确写出返回类型

无返回值的函数(类似Java中的void):

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


// 如果是返回 Unit类型,则可以省略(对于public方法也是这样):
public fun printSum(a: Int, b: Int) { 
    print(a + b)
}

可变长参数函数

函数的变长参数可以用 vararg 关键字进行标识:

fun vars(vararg v:Int){
    for(vt in v){
        print(vt)
    }
}

// 测试
fun main(args: Array<String>) {
    vars(1,2,3,4,5)  // 输出12345
}

lambda(匿名函数)

lambda表达式使用实例:

// 测试
fun main(args: Array<String>) {
    val sumLambda: (Int, Int) -> Int = {x,y -> x+y}
    println(sumLambda(1,2))  // 输出 3
}

定义常量与变量

可变变量定义:var 关键字

var <标识符> : <类型> = <初始化值>

不可变变量定义:val 关键字,只能赋值一次的变量(类似Java中final修饰的变量,其他语言中的const)

val <标识符> : <类型> = <初始化值>

常量与变量都可以没有初始化值,但是在引用前必须初始化
编译器支持自动类型判断,即声明时可以不指定类型,由编译器判断。

val a: Int = 1
val b = 1       // 系统自动推断变量类型为Int
val c: Int      // 如果不在声明时初始化则必须提供变量类型
c = 1           // 明确赋值


var x = 5        // 系统自动推断变量类型为Int
x += 1           // 变量可修改

顶层变量:

val PI = 3.14
var x = 0

fun incrementX() { 
    x += 1 
}

注释

Kotlin 支持单行和多行注释,实例如下:

// 这是一个单行注释


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

与 Java 不同, Kotlin 中的块注释允许嵌套。

字符串模板

$ 表示一个变量名或者变量值

  • $varName 表示变量值
  • ${varName.fun()} 表示变量的方法返回值 ```kotlin var a = 1 // 模板中的简单名称: val s1 = “a is $a”

a = 2 // 模板中的任意表达式: val s2 = “${s1.replace(“is”, “was”)}, but now is $a”

1
2
3
4
5
6
7
8

<a name="FmKAd"></a>
## 集合
对集合进行迭代:
```kotlin
for (item in items) {
    println(item)
}

使用 in 运算符来判断集合内是否包含某实例:

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

使用 lambda 表达式来过滤(filter)与映射(map)集合:

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

条件表达式

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

for 循环

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

或者

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

while 循环

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

when 表达式

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

  describe("一缕清风");
}

NULL检查机制

Kotlin的空安全设计对于声明可为空的参数,在使用时要进行空判断处理,有两种处理方式,字段后加!!像Java一样抛出空异常,另一种字段后加?可不做处理返回值为 null或配合?:做空判断处理

//类型后面加?表示可为空
var age: String? = "23" 

//抛出空指针异常
val ages = age!!.toInt()

//不做处理返回 null
val ages1 = age?.toInt()

//age为空返回-1
val ages2 = age?.toInt() ?: -1

当一个引用可能为 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.
  if (x != null && y != null) {
    // 在进行过 null 值检查之后, x 和 y 的类型会被自动转换为非 null 变量
    print(x * y)
  }
}

类型检测及自动类型转换

我们可以使用 is 运算符检测一个表达式是否某类型的一个实例(类似于Java中的instanceof关键字)。

fun getStringLength(obj: Any): Int? {
  if (obj is String) {
    // 做过类型判断以后,obj会被系统自动转换为String类型
    return obj.length 
  }

  //在这里还有一种方法,与Java中instanceof不同,使用!is
  // if (obj !is String){
  //   // XXX
  // }

  // 这里的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
}

区间

区间表达式由具有操作符形式 .. 的 rangeTo 函数辅以 in 和 !in 形成。
使用 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 (i in 1..4) print(i) // 输出“1234”

for (i in 4..1) print(i) // 什么都不输出

if (i in 1..10) { // 等同于 1 <= i && i <= 10
    println(i)
}

// 使用 step 指定步长
for (i in 1..4 step 2) print(i) // 输出“13”

for (i in 4 downTo 1 step 2) print(i) // 输出“42”


// 使用 until 函数排除结束元素
for (i in 1 until 10) {   // i in [1, 10) 排除了 10
     println(i)
}

实例测试

fun main(args: Array<String>) {
  print("循环输出:")
  for (i in 1..4) print(i) // 输出“1234”
  println("\n----------------")
  print("设置步长:")
  for (i in 1..4 step 2) print(i) // 输出“13”
  println("\n----------------")
  print("使用 downTo:")
  for (i in 4 downTo 1 step 2) print(i) // 输出“42”
  println("\n----------------")
  print("使用 until:")
  // 使用 until 函数排除结束元素
  for (i in 1 until 4) {   // i in [1, 4) 排除了 4
      print(i)
  }
  println("\n----------------")
}

/* 
循环输出:1234
----------------
设置步长:13
----------------
使用 downTo:42
----------------
使用 until:123
---------------- 
*/