kotlin 官方学习教程之编码风格
来源:互联网 发布:网络赌钱正规吗 编辑:程序博客网 时间:2024/05/17 23:15
本页包含了当前 kotlin 语言的代码风格。
命名风格
如有疑惑,默认为 Java 编码风格,比如:
使用 camelCase 命名法(在命名中避免下划线)
类型名称首字母用大写
方法和属性名称首字母用小写
缩进用四个空格
public 方法要写说明文档,这样它就可以出现在 Kotllin Doc 中
冒号
在冒号区分类型和父类型中要有空格,在实例和类型之间是没有空格的:
interface Foo<out T : Any> : Bar { fun foo(a: Int): T}
Lambdas
在 Lambdas 表达式中,大括号与表达式间要有空格,箭头与参数和函数体间要有空格。尽可能的把 lambda 放在括号外面传入
list.filter { it > 10 }.map { element -> element * 2 }
在使用简短而非嵌套的 lambda 中,建议使用 it
而不是显式地声明参数。在使用参数的嵌套 lambda 中,参数应该总是显式声明。
类声明格式
参数比较少的类可以用一行表示:
class Person(id: Int, name: String)
具有较多的参数的类应该格式化成每个构造函数的参数都位于与缩进的单独行中。此外,结束括号应该在新行上。如果我们使用继承,那么超类构造函数调用或实现的接口列表应该位于与括号相同的行中。
class Person( id: Int, name: String, surname: String) : Human(id, name) { // ...}
对于多个接口,应该首先定位超类构造函数调用,然后每个接口应该位于不同的行中:
class Person( id: Int, name: String, surname: String) : Human(id, name), KotlinMaker { // ...}
构造函数参数可以使用常规缩进或连续缩进(双倍正常缩进)。
Unit
如果函数返回类型为 Unit ,返回类型应该省略:
fun foo() { // ": Unit"被省略了}
函数 vs 属性
在某些情况下,没有参数的函数可以与只读属性互换。尽管语义是相似的,但是有一些风格上的约定在什么时候更偏向于另一个。
在下面的情况下,更偏向于属性而不是一个函数:
不需要抛出异常
拥有O(1)复杂度
低消耗的计算(或首次运行结果会被缓存)
返回与调用相同的结果
阅读全文
2 0
- kotlin 官方学习教程之编码风格
- kotlin 官方学习教程之基础语法
- kotlin 官方学习教程之语法
- kotlin 官方学习教程之基本类型
- kotlin 官方学习教程之包
- Kotlin 官方学习教程之控制流
- Kotlin 官方学习教程之接口
- Kotlin 官方学习教程之扩展
- Kotlin 官方学习教程之返回和跳转
- Kotlin 官方学习教程之属性和字段
- Kotlin 官方学习教程之可见性修饰符
- Kotlin 官方学习教程之密封类与泛型
- Python3.2 官方文档教程---编码风格
- Kotlin编码规范和基本类型--kotlin官方文档学习
- Kotlin 官方学习教程之类和继承
- kotlin编码风格指南-源文件
- kotlin编码风格指南-格式化
- [kotlin系列] (s1_1) 代码风格、编码规范
- JS设置cookie、读取cookie、删除cookie
- Bootstrap分割线
- 修改oracle中内存占用大小
- 上传文件
- “模板类与友元”那些事(C++)
- kotlin 官方学习教程之编码风格
- JNI的线程处理
- Error:SSL peer shut down incorrectly
- android热修复--阿里热修复使用和源码分析
- 数据、结构、算法
- 细谈C++的运算符重载
- 我为什么鼓励工程师写blog
- oracle 常用的 sql
- UVa232 Crossword Answers AC