Swift5.3 语言指南(二十二) 扩展

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/9739746.html  
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

扩展为现有的类，结构，枚举或协议类型添加了新功能。这包括扩展无法访问原始源代码的类型的能力（称为追溯建模）。扩展与Objective-C中的类别相似。（与Objective-C类别不同，Swift扩展没有名称。）

Swift中的扩展可以：

• 添加计算实例属性和计算类型属性
• 定义实例方法和类型方法
• 提供新的初始化器
• 定义下标
• 定义和使用新的嵌套类型
• 使现有类型符合协议

在Swift中，您甚至可以扩展协议以提供其要求的实现，或添加符合性类型可以利用的其他功能。有关更多详细信息，请参见协议扩展。

注意

扩展可以为类型添加新功能，但不能覆盖现有功能。

扩展语法

使用extension关键字声明扩展名：

1. extension SomeType {
2. // new functionality to add to SomeType goes here
3. }

扩展可以扩展现有类型以使其采用一种或多种协议。要添加协议一致性，请使用与为类或结构编写协议名称相同的方式编写协议名称：

1. extension SomeType: SomeProtocol, AnotherProtocol {
2. // implementation of protocol requirements goes here
3. }

在以扩展方式添加协议一致性中描述了以这种方式添加协议一致性。

扩展可用于扩展现有的通用类型，如扩展通用类型中所述。您还可以扩展泛型类型以有条件地添加功能，如使用泛型子句的扩展中所述。

注意

如果定义扩展以将新功能添加到现有类型，则新功能将在该类型的所有现有实例上可用，即使它们是在定义扩展之前创建的。

计算属性

扩展可以将计算的实例属性和计算的类型属性添加到现有类型。本示例向Swift的内置Double类型添加了五个计算实例属性，为使用距离单位提供基本支持：

1. extension Double {
2. var km: Double { return self * 1_000.0 }
3. var m: Double { return self }
4. var cm: Double { return self / 100.0 }
5. var mm: Double { return self / 1_000.0 }
6. var ft: Double { return self / 3.28084 }
7. }
8. let oneInch = 25.4.mm
9. print("One inch is (oneInch) meters")
10. // Prints "One inch is 0.0254 meters"
11. let threeFeet = 3.ft
12. print("Three feet is (threeFeet) meters")
13. // Prints "Three feet is 0.914399970739201 meters"

这些计算的属性表示Double应将值视为某个长度单位。尽管将它们实现为计算属性，但是可以使用点语法将这些属性的名称附加到浮点文字值上，以作为使用该文字值执行距离转换的一种方式。

在此示例中，Double值1.0视为代表“一米”。这就是m计算的属性返回self的原因-该表达式1.m被视为计算的Double值1.0。

其他单位需要某种换算，以米为单位来表示。一公里等于1,000米，因此km计算出的属性将值乘以1_000.00以转换成以米表示的数字。同样，一米中有3.28084英尺，因此，ft计算出的属性会将基础Double值除以3.28084，以将其从英尺转换为米。

这些属性是只读的计算属性，因此get为了简洁起见，它们不使用关键字来表示。它们的返回值类型为Double，并且可以在Double接受a的数学计算中使用：

1. let aMarathon = 42.km + 195.m
2. print("A marathon is (aMarathon) meters long")
3. // Prints "A marathon is 42195.0 meters long"

注意

扩展可以添加新的计算属性，但不能添加存储的属性，也不能将属性观察器添加到现有属性。

初始化器

扩展可以向现有类型添加新的初始化器。这使您可以扩展其他类型，以接受自己的自定义类型作为初始化程序参数，或提供未包含在该类型的原始实现中的其他初始化选项。

扩展可以将新的便捷初始化程序添加到类，但是不能将新的指定初始化程序或反初始化程序添加到类。指定的初始化程序和反初始化程序必须始终由原始类实现提供。

如果使用扩展将初始值设定项添加到为其所有存储属性提供默认值且未定义任何自定义初始值设定项的值类型，则可以从扩展程序的初始值设定项中调用该值类型的默认初始值设定项和逐成员初始值设定项。如果您将初始化程序编写为值类型的原始实现的一部分，则情况并非如此，如“值类型的初始化程序委托”中所述。

如果使用扩展将初始化程序添加到在另一个模块中声明的结构，则新的初始化程序将无法访问，self直到它从定义模块调用初始化程序。

下面的示例定义了一个自定义Rect结构来表示几何矩形。该示例还定义了两个称为Size和的支持结构Point，这两个结构都0.0为其所有属性提供默认值：

1. struct Size {
2. var width = 0.0, height = 0.0
3. }
4. struct Point {
5. var x = 0.0, y = 0.0
6. }
7. struct Rect {
8. var origin = Point()
9. var size = Size()
10. }

因为该Rect结构为其所有属性提供默认值，所以它会自动接收一个默认初始化程序和一个成员初始化程序，如Default Initializers中所述。这些初始化程序可用于创建新Rect实例：

1. let defaultRect = Rect()
2. let memberwiseRect = Rect(origin: Point(x: 2.0, y: 2.0),
3. size: Size( 5.0, height: 5.0))

您可以扩展该Rect结构以提供一个附加的初始化程序，该初始化程序具有特定的中心点和大小：

1. extension Rect {
2. init(center: Point, size: Size) {
3. let originX = center.x - (size.width / 2)
4. let originY = center.y - (size.height / 2)
5. self.init(origin: Point(x: originX, y: originY), size: size)
6. }
7. }

这个新的初始值设定项从根据提供的center点和size值计算适当的起点开始。然后，初始化器调用结构的自动成员式初始化器init(origin:size:)，该初始化器将新的origin和size值存储在适当的属性中：

1. let centerRect = Rect(center: Point(x: 4.0, y: 4.0),
2. size: Size( 3.0, height: 3.0))
3. // centerRect's origin is (2.5, 2.5) and its size is (3.0, 3.0)

注意

如果您为新的初始化程序提供扩展名，则一旦初始化程序完成，您仍然有责任确保每个实例都已完全初始化。

方法

扩展可以向现有类型添加新的实例方法和类型方法。下面的示例repetitions向该Int类型添加一个新的实例方法：

1. extension Int {
2. func repetitions(task: () -> Void) {
3. for _ in 0..<self {
4. task()
5. }
6. }
7. }

该repetitions(task:)方法采用类型为的单个参数，该参数表示没有参数且不返回值的函数。() -> Void

定义此扩展名后，您可以repetitions(task:)在任何整数上调用方法来执行多次任务：

1. 3.repetitions {
2. print("Hello!")
3. }
4. // Hello!
5. // Hello!
6. // Hello!

变异实例方法

添加了扩展名的实例方法还可以修改（或变异）实例本身。修改self其属性的结构和枚举方法或其实例属性必须将实例方法标记为mutating，就像从原始实现中对方法进行变异一样。

以下示例square为Swift的Int类型添加了一个新的变异方法，该方法将原始值平方：

1. extension Int {
2. mutating func square() {
3. self = self * self
4. }
5. }
6. var someInt = 3
7. someInt.square()
8. // someInt is now 9

下标

扩展可以将新的下标添加到现有类型。本示例向Swift的内置Int类型添加整数下标。此下标[n]返回数字n右边的小数位数：

• 123456789[0] 退货 9
• 123456789[1] 退货 8

…等等：

1. extension Int {
2. subscript(digitIndex: Int) -> Int {
3. var decimalBase = 1
4. for _ in 0..<digitIndex {
5. decimalBase *= 10
6. }
7. return (self / decimalBase) % 10
8. }
9. }
10. 746381295[0]
11. // returns 5
12. 746381295[1]
13. // returns 9
14. 746381295[2]
15. // returns 2
16. 746381295[8]
17. // returns 7

如果该Int值没有足够的位数来存储所请求的索引，则下标实现将返回0，就好像该数字已在左侧填充了零：

1. 746381295[9]
2. // returns 0, as if you had requested:
3. 0746381295[9]

嵌套类型

扩展可以将新的嵌套类型添加到现有的类，结构和枚举中：

1. extension Int {
2. enum Kind {
3. case negative, zero, positive
4. }
5. var kind: Kind {
6. switch self {
7. case 0:
8. return .zero
9. case let x where x > 0:
10. return .positive
11. default:
12. return .negative
13. }
14. }
15. }

本示例向中添加了一个新的嵌套枚举Int。此枚举称为Kind，表示特定整数表示的数字的种类。具体来说，它表示数字是负数，零还是正数。

本示例还向添加了一个新的计算实例属性Int，称为kind，该属性返回该Kind整数的相应枚举大小写。

嵌套枚举现在可以与任何Int值一起使用：

1. func printIntegerKinds(_ numbers: [Int]) {
2. for number in numbers {
3. switch number.kind {
4. case .negative:
5. print("- ", terminator: "")
6. case .zero:
7. print("0 ", terminator: "")
8. case .positive:
9. print("+ ", terminator: "")
10. }
11. }
12. print("")
13. }
14. printIntegerKinds([3, 19, -27, 0, -6, 0, 7])
15. // Prints "+ + - 0 - 0 + "

此函数printIntegerKinds(_:)接受Int值的输入数组，然后依次迭代这些值。对于数组中的每个整数，函数将考虑该kind整数的计算属性，并输出适当的描述。

注意

number.kind已经知道是类型Int.Kind。因此，所有Int.Kindcase值都可以用简写形式写在switch语句中，例如.negative而不是Int.Kind.negative。