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

import UIKit

// # 存儲(chǔ)屬性
// 存儲(chǔ)屬性會(huì)存儲(chǔ)常量或變量作為實(shí)例的一部分妈踊，存儲(chǔ)屬性只能由類和結(jié)構(gòu)體定義晰奖。
struct FixedLengthRange {
    var firstValue: Int
    let length: Int
}
// 沒有默認(rèn)的初始化器,但是有默認(rèn)的賦值初始化器
var rangeOfThreeItems = FixedLengthRange(firstValue: 0, length: 3)
// 延遲存儲(chǔ)屬性在其第一次使用時(shí)才進(jìn)行計(jì)算.而且必須是var.作用:提高效率,有時(shí)是必須這樣才能解決問題***
class LazyDemo {
    var b = 0
    var c = 3
    lazy var a = FixedLengthRange(firstValue: b, length: c)
    
}
// 若不加lazy會(huì)報(bào)錯(cuò): property initializers run before 'self' is available. 加上lazy就得到完美解決
// 如果被標(biāo)記為 lazy 修飾符的屬性同時(shí)被多個(gè)線程訪問并且屬性還沒有被初始化肩刃，則無法保證屬性只初始化一次。???

// # 計(jì)算屬性
// 計(jì)算屬性會(huì)計(jì)算（而不是存儲(chǔ))值,計(jì)算屬性可以由類任斋、結(jié)構(gòu)體和枚舉定義萝勤。注意:計(jì)算屬性必須用var定義,不管是不是只讀屬性.計(jì)算屬性也是延遲的,所以可以在定義階段恣意調(diào)用類中的屬性***
struct Point {
    var x = 0.0, y = 0.0
}
struct Size {
    var width = 0.0, height = 0.0
}
struct Rect {
    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(newCenter) {
            origin.x = newCenter.x - (size.width / 2)
            origin.y = newCenter.y - (size.height / 2)
        }// 計(jì)算屬性本身并不存儲(chǔ),所以set中,沒有任何值存儲(chǔ),只是實(shí)例中的origin屬性被改變了,(newCenter)可以不要,有一個(gè)默認(rèn)的newValue可以代替newCenter使用
    }
}
var square = Rect(origin: Point(), size: Size(width: 10, height: 10))
let initialSquareCenter = square.center
square.center = Point(x: 15, y: 15)
print("square.origin is now at (\(square.origin.x), \(square.origin.y))")
// 只讀屬性,沒有setter只有g(shù)etter.而且可以簡(jiǎn)寫

// # 屬性觀察者
// 每當(dāng)一個(gè)屬性的值被設(shè)置時(shí)露筒，屬性觀察者都會(huì)被調(diào)用，即使這個(gè)值與該屬性當(dāng)前的值相同敌卓。
// 可以為任意存儲(chǔ)屬性添加屬性觀察者慎式，除了延遲存儲(chǔ)屬性。也可以通過在子類里重寫屬性來為任何繼承屬性（無論是存儲(chǔ)屬性還是計(jì)算屬性）添加屬性觀察者趟径。不需要為非重寫的計(jì)算屬性定義屬性觀察者瘪吏，因?yàn)榭梢栽谟?jì)算屬性的設(shè)置器里直接觀察和響應(yīng)它們值的改變。
// 父類屬性的 willSet 和 didSet 觀察者會(huì)在子類初始化器中設(shè)置時(shí)被調(diào)用***蜗巧。它們不會(huì)在類的父類初始化器調(diào)用中設(shè)置其自身屬性時(shí)被調(diào)用掌眠。***
class StepCounter {
    var totalSteps: Int = 0 {
        willSet(newTotalSteps) { // 可以不要命名,函數(shù)體中使用newValue即可
            print("About to set totalSteps to \(newTotalSteps)")
        }
        didSet {
            if totalSteps > oldValue {
                print("Added \(totalSteps - oldValue) steps")
            }
        }
    }
    init(rawSteps: Int) {
        totalSteps = rawSteps
    }
}
let stepCounter = StepCounter(rawSteps: 20)
stepCounter.totalSteps = 200
// 如果你以輸入輸出形式參數(shù)傳一個(gè)擁有觀察者的屬性給函數(shù)， willSet 和 didSet 觀察者一定會(huì)被調(diào)用幕屹。這是由于輸入輸出形式參數(shù)的拷貝入拷貝出存儲(chǔ)模型導(dǎo)致的：值一定會(huì)在函數(shù)結(jié)束后寫回屬性蓝丙。***

// # 全局和局部變量
// 全局變量是定義在任何函數(shù)级遭、方法、閉包或者類型環(huán)境之外的變量渺尘。局部變量是定義在函數(shù)挫鸽、方法或者閉包環(huán)境之中的變量。
// 全局常量和變量永遠(yuǎn)是延遲計(jì)算的鸥跟，與延遲存儲(chǔ)屬性有著相同的行為丢郊。不同于延遲存儲(chǔ)屬性，全局常量和變量不需要標(biāo)記 lazy 修飾符
var a = 0 {
    didSet {
        print("a's old value is \(oldValue)")
    }
}
a += 1

// # 類型屬性
// 實(shí)例屬性是屬于某個(gè)類型實(shí)例的屬性医咨。每次創(chuàng)建這個(gè)類型的新實(shí)例蚂夕，它就擁有一堆屬性值，與其他實(shí)例不同腋逆。
struct SomeStructure {
    static var storedTypeProperty = "Some value."
    static var computedTypeProperty: Int {
        return 1
    }
}
enum SomeEnumeration { // trick: 這個(gè)enum沒有定義自己的成員,但是有類型屬性
    static var storedTypeProperty = "Some value."
    static var computedTypeProperty: Int {
        return 6
    }
}
// 以上static的屬性都不能被子類重寫.要允許重寫并且屬性是計(jì)算屬性,標(biāo)注class關(guān)鍵字.
class Dream {
    class var text: String {
        return "A sweet one."
    }
}
class SpecificDream: Dream {
    static var earlyYear = 0
    override class var text: String {
        return "A sweet one since \(earlyYear)"
    }
}

// 不同于存儲(chǔ)實(shí)例屬性婿牍，你必須總是給存儲(chǔ)類型屬性一個(gè)默認(rèn)值。這是因?yàn)轭愋捅旧聿荒軗碛心軌蛟诔跏蓟瘯r(shí)給存儲(chǔ)類型屬性賦值的初始化器惩歉。
// 存儲(chǔ)類型屬性是在它們第一次訪問時(shí)延遲初始化的等脂。但是只初始化一次.
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)
struct AudioChannel {
    static let thresholdLevel = 10
    static var maxInputLevelForAllChannels = 0
    var currentLevel: Int = 0 {
        didSet {
            if currentLevel > AudioChannel.thresholdLevel {
                // cap the new audio level to the threshold level
                currentLevel = AudioChannel.thresholdLevel
            }
            if currentLevel > AudioChannel.maxInputLevelForAllChannels {
                // store this as the new overall maximum input level
                // 成為目前為止所有AudioChannel實(shí)例的最大值
                AudioChannel.maxInputLevelForAllChannels = currentLevel
            }
        }
    }
}
// 類型屬性可以在任何地方訪問.