Базовый синтаксис Kotlin

Файлы Kotlin заканчиваются на.ktв качестве суффикса.

Объявление пакета

В начале файла с кодом обычно находится объявление пакета:

package com.example.main

import java.util.*

fun test() {}
class Example {}

Исходные файлы Kotlin не требуют соответствия каталога и пакета; исходные файлы можно размещать в любом каталоге файлов.

В приведённом выше примере полное имя test() — com.example.main.test, а полное имя Example — com.example.main.Example.

Если пакет не указан, по умолчанию используетсяdefaultпакет.

Импорты по умолчанию

В каждый файл Kotlin по умолчанию импортируется несколько пакетов:

  • kotlin.*
  • kotlin.annotation.*
  • kotlin.collections.*
  • kotlin.comparisons.*
  • kotlin.io.*
  • kotlin.ranges.*
  • kotlin.sequences.*
  • kotlin.text.*

Определение функции

Определения функций используют ключевое слово fun, а формат параметра: параметр : тип

fun sum(a: Int, b: Int): Int {   // Int 参数，返回值 Int
    return a + b
}

Выражение в качестве тела функции, с автоматически выводимым типом возвращаемого значения:

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

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

Функция без возвращаемого значения (аналогично void в Java):

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 (анонимная функция)

Пример использования лямбда-выражения:

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

Определение констант и переменных

Определение изменяемой переменной: ключевое слово var

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

Определение неизменяемой переменной: ключевое слово val, переменная, которой можно присвоить значение только один раз (аналогично переменной, изменённой с помощью final в Java)

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

И константы, и переменные могут быть без начальных значений, но они должны быть инициализированы до обращения к ним.

Компилятор поддерживает автоматический вывод типов, то есть при объявлении можно опустить тип и позволить компилятору вывести его.

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


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

Комментарии

Kotlin поддерживает однострочные и многострочные комментарии, как показано в следующем примере:

// This is a single-line comment

/* This is a multi-line
   block comment. */

В отличие от Java, блочные комментарии в Kotlin допускают вложенность.

Шаблоны строк

$ обозначает имя переменной или значение переменной

$varName представляет значение переменной

${varName.fun()} представляет возвращаемое значение метода переменной:

var a = 1
// 模板中的简单名称：
val s1 = "a is $a" 

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

Механизм проверки на NULL

Дизайн Kotlin с поддержкой null-безопасности требует обработки null-проверок при использовании параметров, объявленных как nullable. Есть два способа обработки: добавление !! после поля выбрасывает исключение null, как в Java; другой способ — добавление ? после поля, при этом проверку можно оставить необработанной, и возвращаемое значение —nullили с?:для обработки проверок на null.

//类型后面加?表示可为空
var age: String? = "23" 
//抛出空指针异常
val ages = age!!.toInt()
//不做处理返回 null
val ages1 = age?.toInt()
//age为空返回-1
val ages2 = age?.toInt() ?: -1

Когда ссылка может быть null, соответствующее объявление типа должно быть явно помечено как nullable.

Когда строка в str не является целым числом, возвращается null:

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

В следующем примере показано, как использовать функцию, возвращаемое значение которой может быть null:

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

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

    // 直接使用 `x * y` 会导致错误, 因为它们可能为 null
    if (x != null && y != null) {
        // 在进行过 null 值检查之后, x 和 y 的类型会被自动转换为非 null 变量
        println(x * y)
    }
    else {
        println("'$arg1' or '$arg2' is not a number")
    }    
}

fun main() {
    printProduct("6", "7")
    printProduct("a", "7")
    printProduct("a", "b")
}

Или:

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

fun printProduct(arg1: String, arg2: String) {
    val x = parseInt(arg1)
    val y = parseInt(arg2)
    
    // ...
    if (x == null) {
        println("Wrong number format in arg1: '$arg1'")
        return
    }
    if (y == null) {
        println("Wrong number format in arg2: '$arg2'")
        return
    }

    // 在进行过 null 值检查之后, x 和 y 的类型会被自动转换为非 null 变量
    println(x * y)
}

fun main() {
    printProduct("6", "7")
    printProduct("a", "7")
    printProduct("99", "b")
}

Проверка типов и автоматическое преобразование типов

Мы можем использовать операторis, чтобы проверить, является ли объект экземпляром указанного типа (аналогично ключевому слову instanceof в Java).

if (obj is Type) {
    // 如果 obj 是 Type 类型，则可以直接使用 Type 类型的属性和方法
} else {
    // 处理其他类型情况
}

КогдаisКогда проверка проходит, Kotlin автоматическиobjрассматривает его как указанный тип, поэтому вifВ ветви оператора нет необходимости явно выполнять преобразование типа. Это называетсяумным преобразованием типов.。

Пример

fun main() {
    val obj: Any = "Hello, Kotlin"

    if (obj is String) {
println("string length: ${obj.length}") // Здесь `obj` был умно приведён к типу `String`
    } else {
println("Not a string type")
    }
}

В этом примере, еслиobjДаStringтип,isоператор возвращаетtrue, Kotlin будетobjраспознавать его какString, поэтому он может напрямую обращаться кStringсвойствам и методам типа.

Дополнительные применения:

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.

Диапазоны определены для любого сравнимого типа, но для целочисленных примитивных типов они имеют оптимизированную реализацию. Ниже приведены некоторые примеры использования диапазонов:

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
----------------
Другие расширения