From cdf564fb08e27b33717ca36762661c6e124a4102 Mon Sep 17 00:00:00 2001 From: AceVest Date: Sun, 26 Mar 2017 16:20:27 +0800 Subject: [PATCH] Swift - Generics AddvancedOperators --- .../Pages/ARC.xcplaygroundpage/Contents.swift | 10 +- .../Contents.swift | 53 ++++++ .../Contents.swift | 6 +- .../Generics.xcplaygroundpage/Contents.swift | 176 ++++++++++++++++++ .../Contents.swift | 4 +- .../Contents.swift | 10 +- .../Contents.swift | 4 +- .../Protocols.xcplaygroundpage/Contents.swift | 108 +++++++++++ .../Contents.swift | 6 +- .../AcePlay.playground/contents.xcplayground | 2 + .../UserInterfaceState.xcuserstate | Bin 28408 -> 29904 bytes 11 files changed, 359 insertions(+), 20 deletions(-) create mode 100644 learn/AcePlay/AcePlay.playground/Pages/AdvancedOperators.xcplaygroundpage/Contents.swift create mode 100644 learn/AcePlay/AcePlay.playground/Pages/Generics.xcplaygroundpage/Contents.swift diff --git a/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift index 5f157bb..07847a7 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/ARC.xcplaygroundpage/Contents.swift @@ -131,12 +131,12 @@ unit7C!.tenant = bill print("----------destroy bill------------") // PersonWeak实例依然保持对ApartmentWeak实例的强引用 // 但是ApartmentWeak实例现在对PersonWeak实例是弱引用 -// 这意味着当你断开bill变量所保持的强引用时，再也没有指向PersonWeak实例的强引用了，由于再也没有指向PersonWeak实例的强引用，该实例会被释放 +// 这意味着当断开bill变量所保持的强引用时，再也没有指向PersonWeak实例的强引用了，由于再也没有指向PersonWeak实例的强引用，该实例会被释放 bill = nil print("----------destroy unit7C------------") -// 现在只剩下来自unit7C变量对ApartmentWeak实例的强引用。如果你打断这个强引用，那么ApartmentWeak实例就再也没有强引用了 +// 现在只剩下来自unit7C变量对ApartmentWeak实例的强引用。如果打断这个强引用，那么ApartmentWeak实例就再也没有强引用了 unit7C = nil @@ -178,7 +178,7 @@ carl = Customer(name: "Carl") carl!.card = CreditCard(number: 314_1414_1732, customer: carl!) // 现在Customer实例对CreditCard实例有一个强引用，并且CreditCard实例对Customer实例有一个无主引用 -// 由于 Customer 的无主引用，当你断开 john 变量持有的强引用时，那么就再也没有指向 Customer 实例的强引用了 +// 由于 Customer 的无主引用，当断开 john 变量持有的强引用时，那么就再也没有指向 Customer 实例的强引用了 // 因为不再有 Customer 的强引用，该实例被释放了。其后，再也没有指向 CreditCard 实例的强引用，该实例也随之被释放了 print("----------destroy carl------------") carl = nil @@ -267,7 +267,7 @@ paragraph = nil // Swift通过闭包捕获列表来解决这个问题 -// Swift要求你在闭包中引用self成员时使用self.someProperty或者self.someMethod 而不只是 someProperty或someMethod）。这有助于提醒你可能会一不小心就捕获了self +// Swift要求在闭包中引用self成员时使用self.someProperty或者self.someMethod 而不只是 someProperty或someMethod）。这有助于提醒可能会一不小心就捕获了self // 捕获列表中的每一项都由 weak 或 unowned 关键字与类实例的引用（如 self ）或初始化过的变量（如 delegate = self.delegate! ）成对组成。这些项写在方括号中用逗号分开。 // 把捕获列表放在形式参数和返回类型前边，如果它们存在的话 @@ -320,4 +320,4 @@ print("----------destroy paragraph2------------") var paragraph2: HTMLElementV2? = HTMLElementV2(name: "p", text: "hello ARC") paragraph2 = nil -print("begin deinit") \ No newline at end of file +print("begin deinit") diff --git a/learn/AcePlay/AcePlay.playground/Pages/AdvancedOperators.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/AdvancedOperators.xcplaygroundpage/Contents.swift new file mode 100644 index 0000000..263016e --- /dev/null +++ b/learn/AcePlay/AcePlay.playground/Pages/AdvancedOperators.xcplaygroundpage/Contents.swift @@ -0,0 +1,53 @@ +//: [Previous](@previous) + +import Foundation + +var str = "Hello, Advanced Operators" + +//: [Next](@next) + + +// 自定义运算符 +// 除了实现标准运算符，在 Swift 中还可以声明和实现自定义运算符 +// 要指定 prefix、infix 或者 postfix 前缀 中缀 后缀 + +struct Vector2D { + var x = 0.0 + var y = 0.0 +} + + +prefix operator +++ +infix operator +-: AdditionPrecedence // 此运算符属于 AdditionPrecedence 优先组 + +extension Vector2D { + + static func + (left: inout Vector2D, right: Vector2D) -> Vector2D { + return Vector2D(x: left.x+right.x, y: left.y+right.y) + } + + static func += (left: inout Vector2D, right: Vector2D) { + left = left + right + } + + + static prefix func +++ (vector: inout Vector2D) -> Vector2D { + vector += vector + return vector + } + + static func +- (left: Vector2D, right: Vector2D) -> Vector2D { + return Vector2D(x: left.x + right.x, y: left.x - right.y) + } +} + + +var va = Vector2D(x: 1.0, y: 2.0) +print(+++va) + +let firstVector = Vector2D(x: 2.0, y: 3.0) +let secondVector = Vector2D(x: 3.0, y: 4.0) +print(firstVector +- secondVector) + + + diff --git a/learn/AcePlay/AcePlay.playground/Pages/Extensions.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/Extensions.xcplaygroundpage/Contents.swift index 4e753f7..1c6abd5 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/Extensions.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/Extensions.xcplaygroundpage/Contents.swift @@ -18,7 +18,7 @@ var str = "Hello, Extensions" // 6. 使一个已有类型符合某个协议 -// 在 Swift 中，你甚至可以对协议进行扩展，提供协议要求的实现，或者添加额外的功能，从而可以让符合协议的类型拥有这些功能 +// 在 Swift 中，甚至可以对协议进行扩展，提供协议要求的实现，或者添加额外的功能，从而可以让符合协议的类型拥有这些功能 // 注意:扩展可以为一个类型添加新的功能，但是不能重写已有的功能。 // 语法 @@ -34,7 +34,7 @@ var str = "Hello, Extensions" // // 协议实现写到这里 //} -// 注意: 如果你通过扩展为一个已有类型添加新功能，那么新功能对该类型的所有已有实例都是可用的，即使它们是在这个扩展定义之前创建的 +// 注意: 如果通过扩展为一个已有类型添加新功能，那么新功能对该类型的所有已有实例都是可用的，即使它们是在这个扩展定义之前创建的 @@ -185,4 +185,4 @@ func printIntegerKinds(_ numbers: [Int]) { var numbers: [Int] = [1, 2, 3, -1, 0, -8] -printIntegerKinds(numbers) \ No newline at end of file +printIntegerKinds(numbers) diff --git a/learn/AcePlay/AcePlay.playground/Pages/Generics.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/Generics.xcplaygroundpage/Contents.swift new file mode 100644 index 0000000..44b508d --- /dev/null +++ b/learn/AcePlay/AcePlay.playground/Pages/Generics.xcplaygroundpage/Contents.swift @@ -0,0 +1,176 @@ +//: [Previous](@previous) + +import Foundation + +var str = "Hello, Generics" + +//: [Next](@next) + +func swapTwoValues(_ a: inout T, _ b: inout T) { + var c: T + c = a + a = b + b = c +} + +var aInt = 3 +var bInt = 4 + +swapTwoValues(&aInt, &bInt) +print(aInt, bInt) + + +var aStr = "aStr" +var bStr = "bStr" +swapTwoValues(&aStr, &bStr) +print(aStr, bStr) + + +// 可提供多个类型参数，将它们都写在尖括号中，用逗号分开 +// 如Dictionary 中的 Key 和 Value + + +class Stack { + var stack = [Element]() + + func push(_ item: Element) { + stack.append(item) + } + + func pop() -> Element? { + return stack.removeLast() + } + + var size: Int { + return stack.count + } +} + +var stackOfStrings = Stack() +stackOfStrings.push("A") +stackOfStrings.push("B") +stackOfStrings.push("C") +stackOfStrings.push("DEFG") + +while stackOfStrings.size > 0 { + var s = stackOfStrings.pop() + print(s!) +} + + + +// 类型约束 +// 可以在一个类型参数名后面放置一个类名或者协议名，并用冒号进行分隔，来定义类型约束 +// 这个函数有两个类型参数。第一个类型参数 T，有一个要求 T 必须是 SomeClass 子类的类型约束；第二个类型参数 U，有一个要求 U 必须符合 SomeProtocol 协议的类型约束 +//func someConstraintGenericFunc(someT: T, someU: U) { +// +//} + + +// Swift 标准库中定义了一个 Equatable 协议，该协议要求任何遵循该协议的类型必须实现等式符（==）及不等符(!=)，从而能对该类型的任意两个值进行比较 +func findIndex(of valueToFind: T, in array: [T]) -> Int? { + for (index, value) in array.enumerated() { + if value == valueToFind { // 需要T类型支持Equatable的协议 + return index + } + } + + return nil +} + +print(findIndex(of: 1.2, in: [1.3, 4.0, 5, 8.9]) ?? "can not find 1.2") +print(findIndex(of: "ace", in: ["john", "obama", "ace"]) ?? "nothing") + + + + +// 关联类型 +// 定义一个协议时，有的时候声明一个或多个关联类型作为协议定义的一部分将会非常有用。 +// 关联类型为协议中的某个类型提供了一个占位名（或者说别名），其代表的实际类型在协议被采纳时才会被指定。 +// 可以通过 associatedtype 关键字来指定关联类型。 + +protocol Container { + associatedtype T + mutating func append(_ item: T) + var count: Int { get } + subscript(i: Int) -> T { get } +} + + +struct StackB: Container { + var stack = [Element]() + + mutating func push(_ item: Element) { + stack.append(item) + } + + mutating func pop() -> Element? { + return stack.removeLast() + } + + var size: Int { + return stack.count + } + + mutating func append(_ item: Element) { + self.push(item) + } + + var count: Int { + return size + } + + subscript(i: Int) -> Element { + return stack[i] + } +} + + + +// +// 通过扩展一个存在的类型来指定关联类型 +// +// 通过扩展添加协议一致性中描述了如何利用扩展让一个已存在的类型符合一个协议，这包括使用了关联类型的协议。 +// +// Swift 的 Array 类型已经提供 append(_:) 方法，一个 count 属性，以及一个接受 Int 类型索引值的下标用以检索其元素。 +// 这三个功能都符合 Container 协议的要求，也就意味着只需简单地声明 Array 采纳该协议就可以扩展 Array，使其遵从 Container 协议。可以通过一个空扩展来实现这点，正如通过扩展采纳协议中的描述： +// +extension Array: Container {} +// 如同上面的泛型 Stack 结构体一样，Array 的 append(_:) 方法和下标确保了 Swift 可以推断出 ItemType 的类型。定义了这个扩展后，可以将任意 Array 当作 Container 来使用。 + + + +// 泛型 Where 语句 +// C1 必须符合 Container 协议（写作 C1: Container）。 +//C2 必须符合 Container 协议（写作 C2: Container）。 +//C1 的T必须和C2的T类型相同（写作 C1.T == C2.T）。 +//C1 的T必须符合Equatable 协议（写作 C1.T: Equatable） +func allItemsMatch(_ someContainer: C1, _ anotherContainer: C2) -> Bool where C1.T == C2.T, C1.T: Equatable { + if someContainer.count != anotherContainer.count { + return false + } + + for i in 0..() +stringStack.push("abc") +stringStack.push("def") +stringStack.push("xyz") + +var stringArray = ["abc", "def", "xyz"] + +if allItemsMatch(stringStack, stringArray) { + print("All items match") +} else { + print("Not all items match") +} + + diff --git a/learn/AcePlay/AcePlay.playground/Pages/Inheritance.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/Inheritance.xcplaygroundpage/Contents.swift index dc1cf1d..da680b4 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/Inheritance.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/Inheritance.xcplaygroundpage/Contents.swift @@ -41,7 +41,7 @@ print("Tandem: \(someTandem.description)") // 重写 // 子类可以为继承来的实例方法，类方法，实例属性，或下标提供自己定制的实现。我们把这种行为叫重写 -// 如果要重写某个特性，你需要在重写定义的前面加上override关键字 +// 如果要重写某个特性，需要在重写定义的前面加上override关键字 class Train: Vehicle { override func makeNoise() { print("Choo Choo") @@ -57,7 +57,7 @@ someTrain.makeNoise() // 可以将一个继承来的只读属性重写为一个读写属性 // 不可以将一个继承来的读写属性重写为一个只读属性 -// 如果在重写属性中提供了setter，那么你也一定要提供getter +// 如果在重写属性中提供了setter，那么也一定要提供getter // 如果不想在重写版本中的getter 里修改继承来的属性值 // 可以直接通过super.someProperty来返回继承来的值，其中someProperty是要重写的属性的名字 diff --git a/learn/AcePlay/AcePlay.playground/Pages/Initialization.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/Initialization.xcplaygroundpage/Contents.swift index a9c2686..67ed19b 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/Initialization.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/Initialization.xcplaygroundpage/Contents.swift @@ -49,7 +49,7 @@ let freezingPointOfWather = Celsius(fromKelvin: 273.15) // 构造器并不像函数和方法那样在括号前有一个可辨别的名字 // 因此在调用构造器时，主要通过构造器中的参数名和类型来确定应该被调用的构造器 -// 正因为参数如此重要，如果你在定义构造器时没有提供参数的外部名字，Swift会为构造器的每个参数自动生成一个跟内部名字相同的外部名 +// 正因为参数如此重要，如果在定义构造器时没有提供参数的外部名字，Swift会为构造器的每个参数自动生成一个跟内部名字相同的外部名 struct Color { var red, green, blue: Double @@ -71,8 +71,8 @@ let magenta = Color(red: 1.0, green: 0.0, blue: 1.0) let halfGray = Color(white: 0.5) -// 如果不通过外部参数名字传值，你是没法调用这个构造器的 -// 只要构造器定义了某个外部参数名，你就必须使用它，忽略它将导致编译错误 +// 如果不通过外部参数名字传值，是没法调用这个构造器的 +// 只要构造器定义了某个外部参数名，就必须使用它，忽略它将导致编译错误 // let green = Color(0.0, 1.0, 0.0) 这段代码会报编译时错误，需要外部名称 let bodyTemperature = Celsius(37.2) @@ -132,7 +132,7 @@ let size1 = Size(width: 2.3, height: 3.7) // 逐一构造器 // 值类型（结构体和枚举类型）的构造器代理不支持继承，所以构造器代理的过程相对简单 // 对于值类型，可以使用self.init在自定义的构造器中引用相同类型中的其它构造器。并且只能在构造器内部调用self.init // 如果为某个值类型定义了一个自定义的构造器，将无法访问到默认构造器（如果是结构体，还将无法访问逐一成员构造器） -// 如果希望默认构造器、逐一成员构造器以及你自己的自定义构造器都能用来创建实例 +// 如果希望默认构造器、逐一成员构造器以及自己的自定义构造器都能用来创建实例 // 可以将自定义的构造器写到扩展（extension）中，而不是写在值类型的原始定义中 struct Point { @@ -266,7 +266,7 @@ print("SomeBicycel: \(someBicycle.description)") // 规则1: 如果子类没有定义任何`指定构造器`，它将自动继承所有父类的指定构造器。 // 规则2: 如果子类提供了所有父类指定构造器的实现——无论是通过规则1继承过来的，还是提供了自定义实现——它将自动继承所有父类的`便利构造器` // 注意: -// 1. 即使你在子类中添加了更多的便利构造器，这两条规则仍然适用。 +// 1. 即使在子类中添加了更多的便利构造器，这两条规则仍然适用。 // 2. 对于规则2，子类可以将父类的指定构造器实现为便利构造器。 diff --git a/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift index 0705036..89cfe4e 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/OptionalChaining.xcplaygroundpage/Contents.swift @@ -180,8 +180,8 @@ print(scores.description) // 连接多层可选链式调用 // 可以通过连接多个可选链式调用在更深的模型层级中访问属性、方法以及下标。然而，多层可选链式调用不会增加返回值的可选层级。 // 也就是说 -// 1. 如果你访问的值不是可选的，可选链式调用将会返回可选值 -// 2. 如果你访问的值就是可选的，可选链式调用不会让可选返回值变得“更可选” +// 1. 如果访问的值不是可选的，可选链式调用将会返回可选值 +// 2. 如果访问的值就是可选的，可选链式调用不会让可选返回值变得“更可选” // 因此 // 通过可选链式调用访问一个Int值，将会返回Int?，无论使用了多少层可选链式调用 diff --git a/learn/AcePlay/AcePlay.playground/Pages/Protocols.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/Protocols.xcplaygroundpage/Contents.swift index fa880fd..59ef2ef 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/Protocols.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/Protocols.xcplaygroundpage/Contents.swift @@ -106,3 +106,111 @@ let generator = LinearCongruentialGenerator() print("Here is a random number: \(generator.random())") print("Here is another random number: \(generator.random())") + + + + + + + +// 类类型专属协议 +protocol SomeClassOnlyProtocol: class { + func haha() -> String +} + +class HahaClass: SomeClassOnlyProtocol { + func haha() -> String { + return "Haha Class" + } +} +// 只能Class继承 +//struct HahaStruct : SomeClassOnlyProtocol { +// func haha() -> String { +// return "Haha Struct" +// } +//} + +let h = HahaClass() +print(h.haha()) + + + +// 协议合成 +// 有时候需要同时遵循多个协议，以将多个协议采用 SomeProtocol & AnotherProtocol 这样的格式进行组合 +protocol Named { + var name: String { get } +} + +protocol Aged { + var age: Int { get } +} + +struct SomeOne: Named, Aged { + var name: String + var age: Int +} + + +func wishHappyBirthday(to celebrator: Named & Aged) { + print("Happy Birthday, \(celebrator.name), you're \(celebrator.age)") +} +wishHappyBirthday(to: SomeOne(name: "Ace", age: 18)) + + +// 检查协议一致性 +protocol Area { + var area: Double { get } +} + +class Circle: Area { + var radius: Double + let pi = 3.1415927 + var area: Double { + get { + return pi*radius*radius + } + } + + init(radius: Double) {self.radius = radius } +} + + +class Country: Area { + var area: Double + init(area: Double) { self.area = area } +} + +class Animal { + var legs: Int + init(legs: Int) { self.legs = legs } +} + +let objects: [AnyObject] = [ + Circle(radius: 45), + Country(area: 960), + Animal(legs: 4) +] + +for o in objects { + if let oa = o as? Area { + print("Area is \(oa.area)") + } else { + print("Something that does not have area") + } +} + + + +// 协议扩展 +// 协议可以通过扩展来为遵循协议的类型提供属性、方法以及下标的实现。通过这种方式，可以基于协议本身来实现这些功能，而无需在每个遵循协议的类型中都重复同样的实现，也无需使用全局函数。 +extension RandomNumberGenerator { + func randomBool() -> Bool { + return random() > 0.5 + } +} + +let generator1 = LinearCongruentialGenerator() +print(generator1.randomBool()) + + + diff --git a/learn/AcePlay/AcePlay.playground/Pages/TypeCasting.xcplaygroundpage/Contents.swift b/learn/AcePlay/AcePlay.playground/Pages/TypeCasting.xcplaygroundpage/Contents.swift index 15f907b..cee1c8e 100644 --- a/learn/AcePlay/AcePlay.playground/Pages/TypeCasting.xcplaygroundpage/Contents.swift +++ b/learn/AcePlay/AcePlay.playground/Pages/TypeCasting.xcplaygroundpage/Contents.swift @@ -63,8 +63,8 @@ print("------------------------------------------------------------------") // 向下转型 -// 某类型的一个常量或变量可能在幕后实际上属于一个子类。当确定是这种情况时，你可以尝试向下转到它的子类型，用类型转换操作符（as? 或 as!） -// 因为向下转型可能会失败，类型转型操作符带有两种不同形式。条件形式as? 返回一个你试图向下转成的类型的可选值。强制形式 as! 把试图向下转型和强制解包转换结果结合为一个操作 +// 某类型的一个常量或变量可能在幕后实际上属于一个子类。当确定是这种情况时，可以尝试向下转到它的子类型，用类型转换操作符（as? 或 as!） +// 因为向下转型可能会失败，类型转型操作符带有两种不同形式。条件形式as? 返回一个试图向下转成的类型的可选值。强制形式 as! 把试图向下转型和强制解包转换结果结合为一个操作 for m in library { if let movie = m as? Movie { @@ -123,7 +123,7 @@ for t in things { // 注意:Any类型可以表示所有类型的值，包括可选类型 -// Swift会在你用Any类型来表示一个可选值的时候，给一个警告。如果确实想使用Any类型来承载可选值，你可以使用as操作符显式转换为Any +// Swift会在用Any类型来表示一个可选值的时候，给一个警告。如果确实想使用Any类型来承载可选值，可以使用as操作符显式转换为Any let optionalNumber: Int? = 3 // things.append(optionalNumber) // 会有warning things.append(optionalNumber as Any) // 不会有warning diff --git a/learn/AcePlay/AcePlay.playground/contents.xcplayground b/learn/AcePlay/AcePlay.playground/contents.xcplayground index e710ae5..b33f343 100644 --- a/learn/AcePlay/AcePlay.playground/contents.xcplayground +++ b/learn/AcePlay/AcePlay.playground/contents.xcplayground @@ -21,5 +21,7 @@ + + \ No newline at end of file diff --git a/learn/AcePlay/AcePlay.playground/playground.xcworkspace/xcuserdata/Ace.xcuserdatad/UserInterfaceState.xcuserstate b/learn/AcePlay/AcePlay.playground/playground.xcworkspace/xcuserdata/Ace.xcuserdatad/UserInterfaceState.xcuserstate index 5ea7ff692d69d081ee2ba99fa007630bd1772563..957e76c24042a8a0efe63b02a4286519828247b0 100644 GIT binary patch delta 13335 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�MEi=&oCEstu6wvBd; zRz`b7dq+=+o)^6!dQtS!7*UKYMiJu{;}O#o^HI$Fn1wM*y3k#mEnQ??6kU{EKI}5P z%iJzpm-$`Z#EN2VV(nt3v5m1)VyDHxtyW4cPjOsqAdsFwR-Dh-vngA2<1TsOGFfL(Q!i^T3i7%7LBsxiyWScZHX=2js zq~@e~Neh#fBrQ)`o3tTmQ_|L??Ma^{?MynCbT8RCS(TifT$EgyJTQ5bC3!;fW~HzzMkUYXpQ+?Kp1d0p~`LkI5Z zDYH`Mq;M(oQWmBxPWd$Dbjourq19-+Xp^*hZHcy*wp?4O?W^sttU)hkt% z>X#ar8l4)O8lT!dwMS}lsx~zz)s$M1IyiMyYGdm7R5o>DYEx=+>b%qisf$yWrmjeB zN!^|Led=FnHfhmm32B*WrnJhmzG?l_K1ds!HZ-j8sP%q_0cg zn7$=_d-~q={pknN52qhZKc4<=`kf3cBPb&-qavdwqdsF?#kvE#~IHuUS_<`c&mdtTb)GbsB_lIbgnw3POa1E zy6Vz&I$gFdS684b(wTKtx@uj2U5###u2wfv$LOZ&=IdH?t95I1>vS7+TXbLQ_UiWO z4(JZ)j_SVAozq>_-PS$Pz0HJ~L?)dn&a}%^WGXW~GQBfZnSPecfJ|*>dFG@{F7wOG zgPCVDf6V+X^J(Vu%$J$3GT&sr%@SqVX4z*sWI1KYvJ_c9S(>catkkT$timi~R!LT` ztn#dytU+0|S;MmGvqof%%Hpy%Wu4FZIa{3VlKy-^@SLtWDLHvLJ#%{JROIx@>6cTJ(~vVV zXH3r6obfqq&V-!hIfru2<=oS|=sop;`bd4EK1;9H=j#o6lSN;u@2l^x|3E)TU#lOc zuh);&Pt|{ToC|4hGA|D}G9{;>X>{+j-0{V)1o^?&H^>mTXg z=E7V&m&z68+T_~jN^{+EeRKVC@8`bA!}IL&-17YL0`o%h!tx^XV)Bymw0Y@yy1cAB zeO_MP2YGYzEGzQ9$h(pEd)|wDET7C5=G)}k=R4%P=X>S*) z^eQMXs4N&%Fr;8uK|{fag3$$y1rrNq6)Y%NU9h=eTfwK6f}I6l7VIrJR&b)=RKb~o za|IU)E*3m4bS(@h)D{jbY$#+4XB5sZY%ZKvxUg_Z;m3t*3)dHJD%?`Iz3|h*y@kgM z&llb(yj%F7@Nwa@!k2}w4U|D-urb&hqy{I0i^0 zBCLok5*FDM*%!GMxfgjB`4ssU`4Wzbl(Eq`&N$gP z*SN&^iE+E}GvhAfZsS+RuZ`atPaDq~&l|rtUNT-W-ZDNkzBUO>P9~Yj)#PsSGO0|V zrU+A%sf#Jj)XkJ&N;egn%1kw;2GdB>7}GctW13)^WtwZ^O!G|(O-oG6Odp#zn|7Nl z`%MQ;M@%P7r%Y!}-bh5iKN7#L{m~!QdKgp zq^)FA$;^3Z*DSAGtV^7F>~gn<`w2v^J?=N^IG#Z^M3P5^JVi*^KJ8Q=DX$x=9lKz z=C>7~0?`CIUKN^(E*0?=-769;6)6?j6}c4!6^05^MM*_vMQz2Xib)l-D&|&v zRI#99amA{Nk1N(ztgqNqv8Cd8#iL3=Wk6*_W!Fk=WqzfxvZS(CWkqG5%6^ptDu-8& ztQ=iAw(^(C$CXbjpI81_)xWBtYIN1uDofSGs-~)GRWquZs}@zYR;{nvS+%EXU)6!C ou%lJSt4>y(uKJb!1k6%}V| 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 -- 2.44.0