Kotlin 语法编码规范

南巷羽 2022-09-29 我要评论

前言

上一篇我们认识了Kotlin编程语言，也搭建好开发环境。本篇就进入Kotlin的基础语法介绍，与其他编程语言一样，Kotlin也有自己的一套编码规范。

文章总览

1.Kotlin基本语法

1.1 函数声明

使用关键字 fun 声明：

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

以上函数有俩个 int 参数：a , b；返回值为 Int 类型值。

在Kotlin中，返回值类型可以自行推断，函数体可以是表达式：这与Java是有区别的，直接用 = 相连

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

无返回值的函数，使用 Unit 为写法更简便可以将 Unit 省略。

fun printSum(a: Int, b: Int): Unit { 
    println("sum of $a and $b is ${a + b}") 
}
// Unit 返回类型可以省略

1.2 程序主入口

Kotlin 程序的入口是 main函数，与 Java 是一样的。

fun main() { 
    println("Hello world!")  // 打印字符串 
}

程序在执行时，会先进入 main 函数开始执行。

1.3 变量

只读局部变量(常量) 使用 val 定义

val a: Int = 1 // ⽴即赋值 
val b = 2 // ⾃动推断出 `Int` 类型 
val c: Int // 如果没有初始值类型不能省略 
c = 3 // 明确赋值

可重新赋值变量使用 var 定义

var x = 5 // ⾃动推断出 `Int` 类型 
x += 1 // x重新赋值

这与 Java 有很大区别，不用指定变量的类型，有编译器自动推断出来。

1.4 条件表达式

与 Java 中的 if 语句一样

if (a > b) { 
    return a 
} else { 
    return b 
}

在 Kotlin中 if 也可以⽤作表达式，更加简便

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

1.5 when表达式

when 将它的参数与所有的分⽀条件顺序⽐较，直到某个分⽀满⾜条件

when (obj) { 
    1 -> "One" 
    "Hello" -> "Greeting" 
    is Long -> "Long" 
    !is String -> "Not a string" 
    else -> "Unknown" 
}

可以类比 Java 中的 switch 语句。

1.6 空值与空检测

一个表达式或者一个变量可以为Null, 在Kotlin中可以使用 ？来结尾表示

fun parseInt(str: String): Int? { // …… }  
// 函数返回值可为空，当返回值 不是 Int 类型，返回值就是Null

这一特性解决了 Java 中一老大难的问题：NullpointException 空指针报错问题，在日常开发中帮开发者提高了不少开发效率和减少了不少bug。

1.7 区间使用

使⽤ in 操作符来检测某个数字是否在指定区间内

val x = 10 
val y = 9 
if (x in 1..y+1) { 
    println("in range") 
}

这个特性可以运用到区间和数列中。

2.Kotlin编码规范

目录结构：可以类比 Java 项目，包名的规则：小写字母，公司/组织域名反写

代码源文件：以 .kt 为扩展名，命名规则首字母大写的驼峰风格，例如 HelloWorld.kt

命名规则：

类与对象的名称以大写字母开头并使用驼峰风格
包的名称总是小写且不使用下划线

文档注释：

多行注释
单行注释

代码缩进风格要统一

注解：将注解放在单独的⾏上，在它们所依附的声明之前，并使⽤相同的缩进

链式调用：对链式调⽤换⾏时，将 . 字符或者 ?. 操作符放在下⼀⾏，带有缩进
不在 . 或者 ?. 左右留空格： foo.bar().filter { it > 2 }.joinToString() , foo?.bar()
在 // 之后留⼀个空格： // 这是⼀条注释
不要在⽤于指定类型参数的尖括号前后留空格： class Map { …… }
不要在 :: 前后留空格： Foo::class 、String::length
不要在⽤于标记可空类型的 ? 前留空格： String?

总结

本文主要讲解 Kotlin 常用的基本语法，后续会针对特定的知识点展开学习，同时学习了Kotlin 编码规范，对日常规范编写代码是非常有帮助。