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

Определение пакетов

Спецификация пакета должна быть в верхней части исходного файла

package my.demo

import java.util.*

// ...

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

Смотрите подробнее о пакетах

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

Функция имеющая два параметра типа Int и возвращающая значения типа Int:

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

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

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

Функция возвращающая не значимое значение:

fun printSum(a: Int, b: Int): Unit {
    println("sum of $a and $b is ${a + b}")
}

Тип возвращаемого значения может быть опущен:

fun printSum(a: Int, b: Int) {
    println("sum of $a and $b is ${a + b}")
}

Определение переменных

Локальная переменная assign-once (только чтение),присвоить значение можно один раз:

val a: Int = 1  // присвоение значения
val b = 2   // подразумевается тип `Int` 
val c: Int  // тип обязателен когда нет инициализации
c = 3       // отложенное присвоение

Mutable переменная, можно изменять значение переменной:

var x = 5 // подразумевается тип `Int`
x += 1

Переменные вверхнего уровня:

val PI = 3.14
var x = 0

fun incrementX() {
    x += 1
}

Использование строковых шаблонов

var a = 1
// простое название в шаблоне:
val s1 = "a is $a"

a = 2
// aпроизвольное выражение в шаблоне:
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
    }
}

Использование if в качестве выражения:

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

Использование nullable значений и проверка на null

Ссылка должна быть явно помечена nullable, когда возможно null значение.

Возвращает null, если str не содержит целое число:

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

Используйте функцию возвращающую null значение

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 после проверки на null
        println(x * y)
    }
    else {
        println("either '$arg1' or '$arg2' is not a number")
    }
}

или

// ...
if (x == null) {
    println("Wrong number format in arg1: '$arg1'")
    return
}
if (y == null) {
    println("Wrong number format in arg2: '$arg2'")
    return
}

// x и y автоматически приводятся к не nullable после проверки на null
println(x * y)

Использование проверок типов и автоматических приведений к типу

Оператор is проверяет, является ли выражение экземпляром типа. Если immutable локальная переменная или property проверяются на конкретный тип, то далле нет необходимости явного приведения:

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

Использование лямбда-выражений для фильтрации и маппинга коллекций:

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) // нет необходимости в слове 'new'
val triangle = Triangle(3.0, 4.0, 5.0)

Поиск по этому блогу

Kotlin