Kotlin学习总结：函数的定义与调用（三）

Kotlin学习总结：函数的定义与调用（三）

处理集合：可变参数、中缀调用和库的支持

• 可变参数的关键字vararg，可以用来声明一个函数将可能有任意数量的参数
• 一个中缀表示法，当你在调用一些只有一个参数的函数时，使用它会让代码更简练
• 解构声明，用来把一个单独的组合值展开到多个变量中

扩展Java集合的API

本部分的前提，是基于Kotlin中的集合与Java的类相同，但对API做了扩展。可以看一个示例，用来获取列表中最后一个元素并找到数字集合中的最大值：

>>> vak strings: List<String> = listOf("first", "second", "fourteenth")
>>> println(strings.last())
fourteenth

>>> val numbers: Collection<Int> = setOf(1, 14, 2)
>>> println(numbers.max())
14

上面例子中的函数last和max都被声明成了扩展函数。

可变参数：让函数支持任意数量的参数

当你在调用一个函数来创建列表的时候，可以传递任意个数的参数给它：

val list = listOf(2, 3, 5, 7, 11)

如果看看这个函数在库当中的声明，将会发现：

fun listOf<T>(vararg values: T): List<T> { ... }

可能对Java的可变参数已经很熟悉了，通过这个功能，可以把任意个数的参数值打包到数组中传给函数。Kotlin的可变参数与Java类似，但语法略有不同：Kotlin在该类型之后不会再使用三个点，而是在参数上使用verarg修饰符。
Kotlin和Java之间的另一个区别是：当需要传递的参数已经包装在数组中时，调用该函数的语法。在Java中，可以按原样传递数组，而Kotlin则要求显式地解包数组，以便每组元素在函数中能作为单独的参数来调用。从技术的角度来讲：这个功能被成为展开运算符，而使用的时候，不过是在对应的参数前面放一个*：

fun main(args: Array<String>) {
    val list = listOf("args: ", *args)  /* 展开运算符展开数组内容 */
    println(list)
}

这个示例展示了，通过展开运算符，可以在单个调用中组合来自数组的值和某些固定值。这在Java中并不支持。

键值对的处理：中缀调用和结构声明

可以使用mapOf函数来创建map：

val map = mapOf(1 to "one", 7 to "seven", 53 tp "fifty-three")

这行代码中的单词to不是内置的结构，而是一种特殊的函数调用，被成为中缀调用。
在中缀调用中，没有添加额外的分隔符，函数名称是直接放在目标对象名称和参数之间的。以下两种调用方式是等价的：

1.to("one")	// 一般to函数的调用
1 to "one"	// 使用中缀符号调用to函数

中缀调用可以与只有一个参数的函数一起使用，无论是普通的函数还是扩展函数。要允许使用中缀符号调用函数，需要使用infix修饰符来标记它。下面是一个简单的to函数的声明：

infix fun Any.to(other: Any) = Pair(this, other)

to函数会返回一个Pair类型的对象，Pait是Kotlin标准库中的类，它会用来表示一对元素。Pair和to的声明都用到了泛型。
注意，可以直接用Pair的内容来初始化两个变量：

val (number, name) = 1 to "one"

这个功能成为结构声明。图3.3展现了它如何与Pair一起使用。

图3.3 用to函数创建一个pair，然后用结构声明来展开
结构声明特征不止用于pair。例如，还可以使用map的key和value内容来初始化两个变量。
这也适用于循环，正如在使用withIndex函数的joinToString实现中看到的：

for ((index, element) in collection.withindex()) {
	println("$index: $element")
}

to函数是一个扩展函数，可以创建一对任何元素，这意味着它是泛型接收者的扩展：可以使用1 to “one”、“one” to 1、list to list.size()等写法。

字符串和正则表达式的处理

Kotlin字符串与Java字符串完全相同。可以将在Kotlin代码中创建的字符串传递给任何Java函数，也可以把任何Kotlin标准库函数应用到从Java代码接受的字符串上，而不用转换，也不用创建附加的包装对象。
Kotlin通过提供一系列有用的扩展函数，使标准Java字符串使用起来更加方便。此外，它还隐藏了一些令人费解的函数，添加了一些更清晰易用的扩展。作为体现API差异化的第一个例子：Kotlin如何分隔字符串。

分隔字符串

Java中的Split方法不适用于一个点号。当代码写为"12.345-6.A".split(".")的时候，期望结果使得到一个[12, 345-6, A]数组。但是Java的split方法会返回一个空数组。因为它将一个正则表达式作为参数，并根据表达式将字符串分割成多个字符串。这里点(.)是表示任何字符的正则表达式。
Kotlin把这个令人费劲的函数隐藏了，作为替换，它提供了一些名为split的，具有不同参数的重载的扩展函数。用来承载正则表达式的值需要一个Regex类型，而不是String。这样确保了当有一个字符串传递给这些函数的时候，不会被当作正则表达式。
这里可以有一个点号或者破折号来分隔字符串：

>>> println("12.345-6.A".split("\\.|-".toRegex())) // 显式地创建一个正则表达式
[12, 345, 6, A]

Kotlin使用与Java完全相同的正则表达式语法。这里的模式匹配一个点（对它进行转义来表示指的是字面量，而不是通配符）或破折号。使用正则表达式的API也类似于标准Java库API，但它们更为通用。例如，在Kotlin中，可以使用扩展函数toRegex将字符串转换为正则表达式。
但对于一些简单的情况，就不需要使用正则表达式了。Kotlin中的split扩展函数的其他重载支持任意数量的纯文本字符串分隔符：

>>> println("12.345-6.A".split(".", "-")) // 指定多个分隔符
[12, 345, 6, A]

注意，可以指定字符参数，并写入"12.345-6.A".split(".", “-”)，这样的结果是相同的。这个方法将替换Java中类似的，只能使用一个字符作为分隔符的方法。

正则表达式和三重引号的字符串

使用两种不同的方式来解析文件的完整路径名称到对应的组件：目录、文件名和扩展名：一个将使用扩展函数来处理字符串，另一个将使用正则表达式。Kotlin标准库包含了一些可以用来获取在给定分隔符第一次（或最后一次）出现之前（或之后）的子字符串的函数。可以这样使用它们来解决这个问题（见图3.4）

图3.4 使用substringBeforeLast和substringAfterLast函数将一个路径分割为目录、文件名和扩展名
使用String的扩展函数来解析文件路径：

fun parsePath(path: String) {
    val directory = path.substringBeforeLast("/")
    val fullName = path.substringAfterLast("/")

    val fileName = fullName.substringBeforeLast(".")
    val extension = fullName.substringAfterLast(".")

    println("Dir: $directory, name: $fileName, ext: $extension")
}
>>> parsePath("/Users/yole/kotlin-book/chapter.adoc")
Dir: /Users/yole/kotlin-book, name: chapter, ext: adoc

path字符串中的最后一个斜线之前的部分，是目录的路径；点号之后的部分，是文件的扩展名；而文件名称，介于两者之间。
使用正则表达式解析文件路径：

fun parsePath(path: String) {
    val regex = """(.+)/(.+)\.(.+)""".toRegex()
    val matchResult = regex.matchEntire(path)
    if (matchResult != null) {
        val (directory, filename, extension) = matchResult.destructured
        println("Dir: $directory, name: $filename, ext: $extension")
    }
}

在这个例子中，正则表达式写在一个三重引号的字符串中。在这样的字符串中，不需要对任何字符进行转移，包括反斜线，所有可以用.而不是\.来表示点，正如写一个普通的字符串字面值（见图3.5）一样。这个正则表达式将一个路径分为三个由斜线和点分隔的组。这个.模式从字符串的一开始就进行匹配，所有第一组（。+）包含最后一个斜线之前的字串。这个字串包含所用前面的斜线，因为它们匹配“任何字符”的模式。同理，第二组包含最后一个点之前的字串，第三组包含剩余部分。

图3.5 使用正则表达式将一个路径分割为目录、文件名和扩展名
上个例子中parePath函数的实现：创建一个正则表达式，并将它与输入路径进行匹配。如果匹配成功（结果不为null），则将它destructured属性赋给相应的变量。

多行三重引号的字符串

三重引号字符串的目的，不仅在于避免转义字符，而且使它可以包含任何字符，包括换行符。另外，它提供了一种更简单的方法，从而可以简单地把包含换行符的文本嵌入到程序中。例如，可以用ASCII码来画点东西：

val kotlinLogo = """| //
                   .|//
                   .|/ \"""
>>> println(kotlinLogo.trimMargin("."))
| //
|//
|/ \

多行字符串包含三重引号之间的所有字符，包括用于格式化代码的缩进。如果要更好地表示这样地字符串，可以去掉缩进（左边距）。为此，可以向字符串内容添加前缀，标记边距地结尾，然后调用trimMargin来删除每行中地前缀和后面地空格。在前面的例子中，它就是使用了点来作为前缀。
一个三重引号的字符串可以包含换行，而不用专门的字符，不如\n。另一方面，可以不必转义字符\，所以Windows风格的路径"C:\Users\yole\kotlin-book"可以写成""“C:\Users\yole\kotlin-book”""。
还可以在多行字符串中使用字符串模板。因为多行字符串不支持转义序列，如果需要在字符串中的内容中使用美元符号的字面量，则必须使用嵌入式表达式，像这样：

val price = """${'$'}99.9"""。

除了使用ASCII的画图游戏外，需要使用多行字符串的一个地方使测试。不需要笨拙的转义或从外部文件中加载文本，只需要一些引号并将预期的HTML或其他输出放在它们中间。

---

注意：可以看到，扩展函数非常强大的地方，使可以扩展现有库的API并且将其适应新语言，有时候被称为Pimp My Library模式。