Android Kotlin 基本語法

基本語法

定義包

包的聲明應處於源文件頂部：

package  my . demo

​

import  java . util . *

​

// ……

目錄與包的結構無需匹配：源代碼可以在文件系統的任意位置。

參見包。

定義函數

帶有兩個Int參數、返回Int的函數：

fun  sum ( a : Int , b : Int ): Int {

    return  a  +  b

}

Target platform: JVM Running on kotlin v. 1.3.11

將表達式作為函數體、返回值類型自動推斷的函數：

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

Target platform: JVM Running on kotlin v. 1.3.11

函數返回無意義的值：

fun  printSum ( a : Int , b : Int ): Unit {

    println ( "sum of $a and $b is ${a + b}" )

}

Target platform: JVM Running on kotlin v. 1.3.11

Unit 返回類型可以省略：

fun  printSum ( a : Int , b : Int ) {

    println ( "sum of $a and $b is ${a + b}" )

}

Target platform: JVM Running on kotlin v. 1.3.11

參見函數。

定義變量

定義只讀局部變量使用關鍵字val定義。只能為其賦值一次。

val  a : Int  =  1   //立即賦值

val  b  =  2    //自動推斷出`Int`類型

val  c : Int   //如果沒有初始值類型不能省略

c  =  3        //明確賦值

Target platform: JVM Running on kotlin v. 1.3.11

可重新賦值的變量使用var關鍵字：

var  x  =  5  //自動推斷出`Int`類型

x  +=  1

Target platform: JVM Running on kotlin v. 1.3.11

頂層變量：

val  PI  =  3.14

var  x  =  0

​

fun  incrementX () {

    x  +=  1 

}

Target platform: JVM Running on kotlin v. 1.3.11

參見屬性與字段。

註釋

正如Java 與JavaScript，Kotlin 支持行註釋及塊註釋。

// 這是一個行註釋

​

/* 這是一個多行的

   塊註釋。*/

與Java 不同的是，Kotlin 的塊註釋可以嵌套。

參見編寫Kotlin代碼文檔查看關於文檔註釋語法的信息。

使用字符串模板

var  a  =  1

// 模板中的簡單名稱：

val  s1  =  "a is $a" 

​

a  =  2

// 模板中的任意表達式：

val  s2  =  "${s1.replace("is", "was")}, but now is $a"

Target platform: JVM Running on kotlin v. 1.3.11

參見字符串模板。

使用條件表達式

fun  maxOf ( a : Int , b : Int ): Int {

    if ( a  >  b ) {

        return  a

    } else {

        return  b

    }

}

Target platform: JVM Running on kotlin v. 1.3.11

使用if作為表達式:

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

Target platform: JVM Running on kotlin v. 1.3.11

參見if表達式。

使用可空值及null檢測

當某個變量的值可以為null的時候，必須在聲明處的類型後添加?來標識該引用可為空。

如果str的內容不是數字返回null：

fun  parseInt ( str : String ): Int ? {

    // ……

}

使用返回可空值的函數:

fun  printProduct ( arg1 : String , arg2 : String ) {

    val  x  =  parseInt ( arg1 )

    val  y  =  parseInt ( arg2 )

​

    // 直接使用`x * y` 會導致編譯錯誤，因為他們可能為null

    if ( x  !=  null  &&  y  !=  null ) {

        // 在空檢測後，x 與y 會自動轉換為非空值（non-nullable）

        println ( x  *  y )

    }

    else {

        println ( "either '$arg1' or '$arg2' is not a number" )

    }    

}

Target platform: JVM Running on kotlin v. 1.3.11

或者

// ……

if ( x  ==  null ) {

    println ( "Wrong number format in arg1: '$arg1'" )

    return

}

if ( y  ==  null ) {

    println ( "Wrong number format in arg2: '$arg2'" )

    return

}

​

// 在空檢測後，x 與y 會自動轉換為非空值

println ( x  *  y )

Target platform: JVM Running on kotlin v. 1.3.11

參見空安全。

使用類型檢測及自動類型轉換

is運算符檢測一個表達式是否某類型的一個實例。如果一個不可變的局部變量或屬性已經判斷出為某類型，那麼檢測後的分支中可以直接當作該類型使用，無需顯式轉換：

fun  getStringLength ( obj : Any ): Int ? {

    if ( obj  is  String ) {

        // `obj` 在該條件分支內自動轉換成`String`

        return  obj . length

    }

​

    // 在離開類型檢測分支後，`obj` 仍然是`Any` 類型

    return  null

}

Target platform: JVM Running on kotlin v. 1.3.11

或者

fun  getStringLength ( obj : Any ): Int ? {

    if ( obj  ! is  String ) return  null

​

    // `obj` 在這一分支自動轉換為`String`

    return  obj . length

}

Target platform: JVM Running on kotlin v. 1.3.11

甚至

fun  getStringLength ( obj : Any ): Int ? {

    // `obj` 在`&&` 右邊自動轉換成`String` 類型

    if ( obj  is  String  &&  obj . length  >  0 ) {

      return  obj . length

    }

​

    return  null

}

Target platform: JVM Running on kotlin v. 1.3.11

參見類以及類型轉換。

使用for循環

val  items  =  listOf ( "apple" , "banana" , "kiwifruit" )

for ( item  in  items ) {

    println ( item )

}

Target platform: JVM Running on kotlin v. 1.3.11

或者

val  items  =  listOf ( "apple" , "banana" , "kiwifruit" )

for ( index  in  items . indices ) {

    println ( "item at $index is ${items[index]}" )

}

Target platform: JVM Running on kotlin v. 1.3.11

參見for循環。

使用while循環

val  items  =  listOf ( "apple" , "banana" , "kiwifruit" )

var  index  =  0

while ( index  <  items . size ) {

    println ( "item at $index is ${items[index]}" )

    index ++

}

Target platform: JVM Running on kotlin v. 1.3.11

參見while循環。

使用when表達式

fun  describe ( obj : Any ): String  =

    when ( obj ) {

        1           ->  "One"

        "Hello"     ->  "Greeting"

        is  Long     ->  "Long"

        ! is  String  ->  "Not a string"

        else        ->  "Unknown"

    }

Target platform: JVM Running on kotlin v. 1.3.11

參見when表達式。

使用區間（range）

使用in運算符來檢測某個數字是否在指定區間內：

val  x  =  10

val  y  =  9

if ( x  in  1 .. y + 1 ) {

    println ( "fits in range" )

}

Target platform: JVM Running on kotlin v. 1.3.11

檢測某個數字是否在指定區間外:

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

}

Target platform: JVM Running on kotlin v. 1.3.11

區間迭代:

for ( x  in  1 .. 5 ) {

    print ( x )

}

Target platform: JVM Running on kotlin v. 1.3.11

或數列迭代：

for ( x  in  1 .. 10  step  2 ) {

    print ( x )

}

println ()

for ( x  in  9  downTo  0  step  3 ) {

    print ( x )

}

Target platform: JVM Running on kotlin v. 1.3.11

參見區間。

使用集合

對集合進行迭代:

for ( item  in  items ) {

    println ( item )

}

Target platform: JVM Running on kotlin v. 1.3.11

使用in運算符來判斷集合內是否包含某實例：

when {

    "orange"  in  items  ->  println ( "juicy" )

    "apple"  in  items  ->  println ( "apple is fine too" )

}

Target platform: JVM Running on kotlin v. 1.3.11

使用lambda 表達式來過濾（filter）與映射（map）集合：

val  fruits  =  listOf ( "banana" , "avocado" , "apple" , "kiwifruit" )

fruits

  . filter { it . startsWith ( "a" ) }

  . sortedBy { it }

  . map { it . toUpperCase () }

  . forEach { println ( it ) }

Target platform: JVM Running on kotlin v. 1.3.11

參見高階函數及Lambda表達式。

創建基本類及其實例：

val  rectangle  =  Rectangle ( 5.0 , 2.0 ) //不需要“new”關鍵字

val  triangle  =  Triangle ( 3.0 , 4.0 , 5.0 )

Target platform: JVM Running on kotlin v. 1.3.11

參見類以及對象與實例。

參考資料，google 繁體中文機器翻譯：https://kotlinlang.org/docs/reference/basic-syntax.html