Swift-方法

//: Playground - noun: a place where people can play

import UIKit

var str = "Hello, playground"

//存储属性
struct FixedLengthRange {
    
    var firstValue:Int
    let lenght:Int?
}

//常量结构体的存储属性
var rangeOfThreeItems = FixedLengthRange(firstValue: 0, lenght: 3);
rangeOfThreeItems.firstValue = 6 ;

//FixedLengthRange的实例包含一个名为firstValue的变量存储属性和一个名为length的常量存储属性。在上面的例子中，length在创建实例的时候被初始化，因为它是一个常量存储属性，所以之后无法修改它的值。

//延迟存储属性
/*
 延迟存储属性是指当第一次被调用的时候才会计算其初始值的属性。在属性声明前使用lazy来标示一个延迟存储属性。
 
 注意：
 必须将延迟存储属性声明成变量（使用var关键字），因为属性的初始值可能在实例构造完成之后才会得到。而常量属性在构造过程完成之前必须要有初始值，因此无法声明成延迟属性。
 延迟属性很有用，当属性的值依赖于在实例的构造过程结束后才会知道具体值的外部因素时，或者当获得属性的初始值需要复杂或大量计算时，可以只在需要的时候计算它。
 */

//下面的例子使用了延迟存储属性来避免复杂类中不必要的初始化。例子中定义了DataImporter和DataManager两个类，下面是部分代码：

class DataImporter {
    
    /*
     DataImporter 是一个将外部文件中的数据导入的类。
     这个类的初始化会消耗不少时间。
     */
    var fileName = "data.txt";
    //这是提供数据导入功能
    
}

class DataManager {
    
    lazy var importer = DataImporter() ;
    var data = [String]() ;
    // 这是提供数据管理功能
}

let manager = DataManager.init() ;
manager.data.append("some data");
manager.data.append("some more data");
// DataImporter 实例的 importer 属性还没有被创建

/*
 DataManager类包含一个名为data的存储属性，初始值是一个空的字符串（String）数组。虽然没有写出全部代码，DataManager类的目的是管理和提供对这个字符串数组的访问。
 
 DataManager的一个功能是从文件导入数据。该功能由DataImporter类提供，DataImporter完成初始化需要消耗不少时间：因为它的实例在初始化时可能要打开文件，还要读取文件内容到内存。
 
 DataManager也可能不从文件中导入数据就完成了管理数据的功能。所以当DataManager的实例被创建时，没必要创建一个DataImporter的实例，更明智的是当第一次用到DataImporter的时候才去创建它。
 
 由于使用了lazy，importer属性只有在第一次被访问的时候才被创建。比如访问它的属性fileName时：
 */

// DataImporter 实例的 importer 属性现在被创建了
// 输出 "data.txt”
print(manager.importer.fileName);

//注意：
//如果一个被标记为lazy的属性在没有初始化时就同时被多个线程访问，则无法保证该属性只会被初始化一次。


/*
 存储属性和实例变量
 
 如果您有过 Objective-C 经验，应该知道 Objective-C 为类实例存储值和引用提供两种方法。对于属性来说，也可以使用实例变量作为属性值的后端存储。
 
 Swift 编程语言中把这些理论统一用属性来实现。Swift 中的属性没有对应的实例变量，属性的后端存储也无法直接访问。这就避免了不同场景下访问方式的困扰，同时也将属性的定义简化成一个语句。一个类型中属性的全部信息——包括命名、类型和内存管理特征——都在唯一一个地方（类型定义中）定义。
 
 */



/*
 计算属性
 
 除存储属性外，类、结构体和枚举可以定义计算属性。计算属性不直接存储值，而是提供一个 getter 和一个可选的 setter，来间接获取和设置其他属性或变量的值。
 
 */


/*
 这个例子定义了 3 个结构体来描述几何形状：
 
 Point封装了一个(x, y)的坐标
 Size封装了一个width和一个height
 Rect表示一个有原点和尺寸的矩形
 Rect也提供了一个名为center的计算属性。一个矩形的中心点可以从原点（origin）和尺寸（size）算出，所以不需要将它以显式声明的Point来保存。Rect的计算属性center提供了自定义的 getter 和 setter 来获取和设置矩形的中心点，就像它有一个存储属性一样。
 
 上述例子中创建了一个名为square的Rect实例，初始值原点是(0, 0)，宽度高度都是10。如下图中蓝色正方形所示。
 
 square的center属性可以通过点运算符（square.center）来访问，这会调用该属性的 getter 来获取它的值。跟直接返回已经存在的值不同，getter 实际上通过计算然后返回一个新的Point来表示square的中心点。如代码所示，它正确返回了中心点(5, 5)。
 
 center属性之后被设置了一个新的值(15, 15)，表示向右上方移动正方形到如下图橙色正方形所示的位置。设置属性center的值会调用它的 setter 来修改属性origin的x和y的值，从而实现移动正方形到新的位置。
 
 */
struct Point {
    var x = 0.0 ;
    var y = 0.0 ;
}
struct Size {
    var width = 0.0 ;
    var height = 0.0 ;
}

struct Rect {
    var origin = Point.init() ;
    var size = Size() ;
    var center : Point {
        
        get {
            let centerX = origin.x + (size.width / 2) ;
            let centerY = origin.y + (size.height / 2) ;
            return Point(x: centerX, y: centerY);
        }
        
        set(newCenter){
            
            origin.x = newCenter.x - (size.width / 2) ;
            origin.y = newCenter.y - (size.height / 2) ;
        }
    }
    
}

var square = Rect(origin: Point(x: 0.0,y: 0.0), size: Size(width: 10.0, height: 10.0)) ;
let initialSquareCenter = square.center ;
square.center = Point(x: 15.0, y: 15.0);
print("square.origin is now at (\(square.origin.x), \(square.origin.y))")


//便捷 setter 声明
//如果计算属性的 setter 没有定义表示新值的参数名，则可以使用默认名称newValue。下面是使用了便捷 setter 声明的Rect结构体代码：
struct AlternativeRect {
    var origin = Point()
    var size = Size()
    var center: Point {
        get {
            let centerX = origin.x + (size.width / 2)
            let centerY = origin.y + (size.height / 2)
            return Point(x: centerX, y: centerY)
        }
        set {
            origin.x = newValue.x - (size.width / 2)
            origin.y = newValue.y - (size.height / 2)
            
        }
    }
}

/*
 只读计算属性
 
 只有 getter 没有 setter 的计算属性就是只读计算属性。只读计算属性总是返回一个值，可以通过点运算符访问，但不能设置新的值。
 
 注意：
 必须使用var关键字定义计算属性，包括只读计算属性，因为它们的值不是固定的。let关键字只用来声明常量属性，表示初始化后再也无法修改的值。
 只读计算属性的声明可以去掉get关键字和花括号：
 */

struct Cuboid {
    var width = 0.0, height = 0.0, depth = 0.0
    var volume: Double {
        return width * height * depth
    }
}
let fourByFiveByTwo = Cuboid(width: 4.0, height: 5.0, depth: 2.0)
print("the volume of fourByFiveByTwo is \(fourByFiveByTwo.volume)")


//属性观察器
/*
 属性观察器监控和响应属性值的变化，每次属性被设置值的时候都会调用属性观察器，甚至新的值和现在的值相同的时候也不例外。
 
 可以为除了延迟存储属性之外的其他存储属性添加属性观察器，也可以通过重载属性的方式为继承的属性（包括存储属性和计算属性）添加属性观察器。属性重载请参考重载。
 
 注意：
 不需要为非重载的计算属性添加属性观察器，因为可以通过它的 setter 直接监控和响应值的变化。
 可以为属性添加如下的一个或全部观察器：
 
 willSet在新的值被设置之前调用
 didSet在新的值被设置之后立即调用
 willSet观察器会将新的属性值作为常量参数传入，在willSet的实现代码中可以为这个参数指定一个名称，如果不指定则参数仍然可用，这时使用默认名称newValue表示。
 
 类似地，didSet观察器会将旧的属性值作为参数传入，可以为该参数命名或者使用默认参数名oldValue。
 
 注意：
 父类的属性在子类的构造器中被赋值时，它在父类中的willSet和didSet观察器会被调用。
 有关构造器代理的更多信息，请参考值类型的构造器代理和类的构造器代理规则。
 这里是一个willSet和didSet的实际例子，其中定义了一个名为StepCounter的类，用来统计当人步行时的总步数。这个类可以跟计步器或其他日常锻炼的统计装置的输入数据配合使用。
 */

class StepCounter {
    
    var totalSteps:Int = 0 {
        willSet(newTotalSteps){
            print("About to set totalSteps to \(newTotalSteps)") ;
        }
        didSet{
            if totalSteps > oldValue {
                
                print("Added \(totalSteps - oldValue) steps")
            }
        }
    }
    
}


let stepCounter = StepCounter.init() ;
stepCounter.totalSteps = 200 ;



/*
StepCounter类定义了一个Int类型的属性totalSteps，它是一个存储属性，包含willSet和didSet观察器。

当totalSteps设置新值的时候，它的willSet和didSet观察器都会被调用，甚至当新的值和现在的值完全相同也会调用。

例子中的willSet观察器将表示新值的参数自定义为newTotalSteps，这个观察器只是简单的将新的值输出。

didSet观察器在totalSteps的值改变后被调用，它把新的值和旧的值进行对比，如果总的步数增加了，就输出一个消息表示增加了多少步。didSet没有为旧的值提供自定义名称，所以默认值oldValue表示旧值的参数名。

注意：
如果在一个属性的didSet观察器里为它赋值，这个值会替换该观察器之前设置的值。
*/






//全局变量和局部变量
/*
 全局变量和局部变量
 
 计算属性和属性观察器所描述的模式也可以用于全局变量和局部变量。全局变量是在函数、方法、闭包或任何类型之外定义的变量。局部变量是在函数、方法或闭包内部定义的变量。
 
 前面章节提到的全局或局部变量都属于存储型变量，跟存储属性类似，它提供特定类型的存储空间，并允许读取和写入。
 
 另外，在全局或局部范围都可以定义计算型变量和为存储型变量定义观察器。计算型变量跟计算属性一样，返回一个计算的值而不是存储值，声明格式也完全一样。
 
 注意：
 全局的常量或变量都是延迟计算的，跟延迟存储属性相似，不同的地方在于，全局的常量或变量不需要标记lazy特性。
 局部范围的常量或变量不会延迟计算。
 */



/*
 类型属性
 
 实例的属性属于一个特定类型实例，每次类型实例化后都拥有自己的一套属性值，实例之间的属性相互独立。
 
 也可以为类型本身定义属性，不管类型有多少个实例，这些属性都只有唯一一份。这种属性就是类型属性。
 
 类型属性用于定义特定类型所有实例共享的数据，比如所有实例都能用的一个常量（就像 C 语言中的静态常量），或者所有实例都能访问的一个变量（就像 C 语言中的静态变量）。
 
 值类型的存储型类型属性可以是变量或常量，计算型类型属性跟实例的计算属性一样只能定义成变量属性。
 
 注意：
 跟实例的存储属性不同，必须给存储型类型属性指定默认值，因为类型本身无法在初始化过程中使用构造器给类型属性赋值。
 */


/*
 类型属性语法
 
 在 C 或 Objective-C 中，与某个类型关联的静态常量和静态变量，是作为全局（global）静态变量定义的。但是在 Swift 编程语言中，类型属性是作为类型定义的一部分写在类型最外层的花括号内，因此它的作用范围也就在类型支持的范围内。
 
 使用关键字static来定义类型属性。在为类（class）定义计算型类型属性时，可以使用关键字class来支持子类对父类的实现进行重写。下面的例子演示了存储型和计算型类型属性的语法：

 */

struct SomeStructure {
    
    static var storedTypeProperty = "Some value" ;
    static var computedTypeProperty:Int {
        
        return 1 ;
    }
}

enum SomeEnumeration {
    static var storedTypeProperty = "Some value."
    static var computedTypeProperty: Int {
        return 6
    }
}


class SomeClass {
    static var storedTypeProperty = "Some value."
    static var computedTypeProperty: Int {
        return 27
    }
    class var overrideableComputedTypeProperty: Int {
        return 107
    }
}

//注意：
//例子中的计算型类型属性是只读的，但也可以定义可读可写的计算型类型属性，跟实例计算属性的语法类似。


//获取和设置类型属性的值
//跟实例的属性一样，类型属性的访问也是通过点运算符来进行。但是，类型属性是通过类型本身来获取和设置，而不是通过实例。比如：

print(SomeStructure.storedTypeProperty) ;
SomeStructure.storedTypeProperty = "Another value"
print(SomeStructure.storedTypeProperty)
print(SomeEnumeration.computedTypeProperty)
print(SomeClass.computedTypeProperty)



/*
 属性currentLevel包含didSet属性观察器来检查每次新设置后的属性值，它有如下两个检查：

如果currentLevel的新值大于允许的阈值thresholdLevel，属性观察器将currentLevel的值限定为阈值thresholdLevel。
如果前一个修正后的currentLevel值大于任何之前任意AudioChannel实例中的值，属性观察器将新值保存在静态类型属性maxInputLevelForAllChannels中。
注意：
在第一个检查过程中，didSet属性观察器将currentLevel设置成了不同的值，但这时不会再次调用属性观察器。
*/
//声道模型使用AudioChannel结构体的实例来表示：
struct AudioChannel {
    static let thresholdLevel = 10 ;
    static var maxInputLevelForAllChannels = 0 ;
    var currentLevel:Int = 0 {
        
        didSet {
            
            if currentLevel > AudioChannel.thresholdLevel {
                
                //将新电平设置为阈值
                currentLevel = AudioChannel.thresholdLevel ;
            }
            if currentLevel > AudioChannel.maxInputLevelForAllChannels {
                
                AudioChannel.maxInputLevelForAllChannels = currentLevel ;
            }
        }
        
    }
    
}

//可以使用结构体AudioChannel来创建表示立体声系统的两个声道leftChannel和rightChannel：

var leftChannel = AudioChannel() ;
var rightChannel = AudioChannel() ;

//如果将左声道的电平设置成 7，类型属性maxInputLevelForAllChannels也会更新成 7：
leftChannel.currentLevel = 7 ;
print(leftChannel.currentLevel) ;
print(AudioChannel.maxInputLevelForAllChannels) ;

rightChannel.currentLevel = 11 ;
print(rightChannel.currentLevel) ;
print(AudioChannel.maxInputLevelForAllChannels) ;