Kotlin 编码约定:水平空格
Kotlin coding conventions: Horizontal whitespace
在 Kotlin 的 coding convention 中,在空白部分注意到:
As a general rule, avoid horizontal alignment of any kind. Renaming an
identifier to a name with a different length should not affect the
formatting of either the declaration or any of the usages.
这是什么意思?
Renaming an identifier to a name with a different length should not
affect the formatting of either the declaration or any of the usages
这是违反该规则的示例:
val b = SomeFluentBuilder()
val result = mutableListOf<String>()
b.foo()
.bar()
.baz()
.build()
将 b
重命名为(例如)someFluentBuilder
会破坏声明中的对齐,也会破坏构建器的使用。
水平对齐是使用空格水平移动文本,使内容垂直对齐。
所以在已经提供的答案中...
val b = SomeFluentBuilder()
val result = mutableListOf<String>()
是水平对齐的一个示例,因为 'val b' 之后的额外空格用于使“=”与下面一行的等号对齐。正确的样式是:
val b = SomeFluentBuilder()
val result = mutableListOf<String>()
此外....为什么选择非常无用的名称'b',而不是可能..
'someFluentBuilder' class 后面的名字是哪个?建议是选择名称只是为了便于对齐示例中的所有点方法调用。重点是不要采取措施使代码与上方或下方的行水平对齐。
在 Kotlin 的 coding convention 中,在空白部分注意到:
As a general rule, avoid horizontal alignment of any kind. Renaming an identifier to a name with a different length should not affect the formatting of either the declaration or any of the usages.
这是什么意思?
Renaming an identifier to a name with a different length should not affect the formatting of either the declaration or any of the usages
这是违反该规则的示例:
val b = SomeFluentBuilder()
val result = mutableListOf<String>()
b.foo()
.bar()
.baz()
.build()
将 b
重命名为(例如)someFluentBuilder
会破坏声明中的对齐,也会破坏构建器的使用。
水平对齐是使用空格水平移动文本,使内容垂直对齐。
所以在已经提供的答案中...
val b = SomeFluentBuilder()
val result = mutableListOf<String>()
是水平对齐的一个示例,因为 'val b' 之后的额外空格用于使“=”与下面一行的等号对齐。正确的样式是:
val b = SomeFluentBuilder()
val result = mutableListOf<String>()
此外....为什么选择非常无用的名称'b',而不是可能.. 'someFluentBuilder' class 后面的名字是哪个?建议是选择名称只是为了便于对齐示例中的所有点方法调用。重点是不要采取措施使代码与上方或下方的行水平对齐。