@H_502_1@
import@H_502_1@ Foundation
@H_502_1@
@H_502_1@/*存储属性@H_502_1@************************************************************/
//@H_502_1@一个存储属性就是存储在特定类或结构体的实例里的一个常量或变量。
@H_502_1@
//@H_502_1@下面的例子定义了一个名为 FixedLengthRange @H_502_1@的结构体,@H_502_1@它描述了一个在创建后无法修改值域宽度的区间:
struct@H_502_1@ FixedLengthRange {
@H_502_1@ var@H_502_1@ firstValue: Int
@H_502_1@ let@H_502_1@ length: Int
@H_502_1@}
var@H_502_1@ rangeOfThreeItems = FixedLengthRange@H_502_1@(firstValue: 0@H_502_1@,length: 3@H_502_1@)
// @H_502_1@该区间表示整数0@H_502_1@,1@H_502_1@,2
@H_502_1@rangeOfThreeItems.@H_502_1@firstValue = 6
// @H_502_1@该区间表示整数6@H_502_1@,7@H_502_1@,8
@H_502_1@
//FixedLengthRange @H_502_1@的实例包含一个名为 firstValue @H_502_1@的变量存储属性和一个名为 length @H_502_1@的常量存储属性。在上 @H_502_1@面的例子中,length @H_502_1@在创建实例的时候被初始化,@H_502_1@因为它是一个常量存储属性,@H_502_1@所以之后无法修改它的值
@H_502_1@
//@H_502_1@如果创建了一个结构体的实例并将其赋值给一个常量,@H_502_1@则无法修改该实例的任何属性,@H_502_1@即使定义了变量存储属性:
let@H_502_1@ rangeOfFourItems = FixedLengthRange@H_502_1@(firstValue: 0@H_502_1@,length: 4@H_502_1@)
@H_502_1@// 该区间表示整数@H_502_1@0,1,2,3
@H_502_1@//rangeOfFourItems.firstValue = 6
@H_502_1@// 尽管@H_502_1@ firstValue 是个变量属性@H_502_1@,这里还是会报错
@H_502_1@//因为@H_502_1@ rangeOfFourItems 被声明成了常量@H_502_1@(用@H_502_1@ let 关键字@H_502_1@),即使@H_502_1@ firstValue 是一个变量属性@H_502_1@,也无法再修改它@H_502_1@ 了。
//@H_502_1@这种行为是由于结构体(struct)@H_502_1@属于值类型。当值类型的实例被声明为常量的时候,@H_502_1@它的所有属性也就成了常 @H_502_1@量。
//@H_502_1@属于引用类型的类(class)@H_502_1@则不一样。把一个引用类型的实例赋给一个常量后,@H_502_1@仍然可以修改该实例的变量属 @H_502_1@性。
@H_502_1@
//@H_502_1@延迟存储属性是指当第一次被调用的时候才会计算其初始值的属性。在属性声明前使用 lazy @H_502_1@来标示一个延迟存储 @H_502_1@属性。
//@H_502_1@必须将延迟存储属性声明成变量(@H_502_1@使用 var @H_502_1@关键字),@H_502_1@因为属性的初始值可能在实例构造完成之后才会得 @H_502_1@到。而常量属性在构造过程完成之前必须要有初始值,@H_502_1@因此无法声明成延迟属性。
@H_502_1@
class@H_502_1@ DataImporter {
@H_502_1@ /*
@H_502_1@ DataImporter 是一个将外部文件中的数据导入的类。@H_502_1@
@H_502_1@这个类的初始化会消耗不少时间。
@H_502_1@ */
@H_502_1@ var@H_502_1@ fileName = "data.txt"
@H_502_1@}
@H_502_1@
class@H_502_1@ DataManager {
@H_502_1@ lazy@H_502_1@ var@H_502_1@ importer = DataImporter@H_502_1@()
@H_502_1@ var@H_502_1@ data = [String@H_502_1@]()
@H_502_1@}
@H_502_1@
let@H_502_1@ manager = DataManager@H_502_1@()
@H_502_1@manager.@H_502_1@data.@H_481_502@append("Some data")
manager.data.@H_481_502@append(@H_502_1@"Some more data")
@H_502_1@// DataImporter实例的@H_502_1@importer属性还没有被创建
@H_502_1@
//@H_502_1@由于使用了 lazy,importer @H_502_1@属性只有在第一次被访问的时候才被创建。比如访问它的属性 fileName @H_502_1@时:
@H_481_502@print(@H_502_1@manager.@H_502_1@importer.@H_502_1@fileName)
@H_502_1@// DataImporter 实例的@H_502_1@ importer 属性现在被创建了@H_502_1@
@H_502_1@// 输出@H_502_1@ "data.txt”
@H_502_1@
//@H_502_1@注意:@H_502_1@如果一个被标记为 lazy @H_502_1@的属性在没有初始化时就同时被多个线程访问,@H_502_1@则无法保证该属性只会被初始化一次。
@H_502_1@
@H_502_1@
@H_502_1@
@H_502_1@/*计算属性@H_502_1@************************************************************/
//@H_502_1@除存储属性外,@H_502_1@类、结构体和枚举可以定义计算属性。计算属性不直接存储值,@H_502_1@而是提供一个 getter @H_502_1@和一个可选 @H_502_1@的 setter,@H_502_1@来间接获取和设置其他属性或变量的值。
struct@H_502_1@ Point {
@H_502_1@ var@H_502_1@ x = 0.0@H_502_1@,y = 0.0
@H_502_1@}
struct@H_502_1@ Size {
@H_502_1@ var@H_502_1@ width = 0.0@H_502_1@,height = 0.0
@H_502_1@}
struct@H_502_1@ Rect {
@H_502_1@ var@H_502_1@ origin = Point@H_502_1@()
@H_502_1@ var@H_502_1@ size = Size@H_502_1@()
@H_502_1@ var@H_502_1@ center: Point@H_502_1@{
@H_502_1@ let@H_502_1@ centerX = origin@H_502_1@.x@H_502_1@ + (size@H_502_1@.width@H_502_1@/2@H_502_1@)
@H_502_1@ let@H_502_1@ centerY = origin@H_502_1@.y@H_502_1@ + (size@H_502_1@.height@H_502_1@/2@H_502_1@)
@H_502_1@ return@H_502_1@ Point@H_502_1@(x: centerX,y: centerY)
@H_502_1@ }
@H_502_1@ set@H_502_1@(newCenter){
@H_502_1@ origin@H_502_1@.x@H_502_1@ = newCenter.x@H_502_1@ - (size@H_502_1@.width@H_502_1@/2@H_502_1@)
@H_502_1@ origin@H_502_1@.y@H_502_1@ = newCenter.y@H_502_1@ - (size@H_502_1@.height@H_502_1@/2@H_502_1@)
@H_502_1@ }
@H_502_1@ }
@H_502_1@}
var@H_502_1@ square = Rect@H_502_1@(origin: Point@H_502_1@(x: 0.0@H_502_1@,y: 0.0@H_502_1@),size: Size@H_502_1@(width: 10.0@H_502_1@,height: 10.0@H_502_1@))
let@H_502_1@ initialSquareCenter = square@H_502_1@.center
@H_502_1@square.@H_502_1@center = @H_502_1@Point(x: 15.0,y:15.0)
@H_481_502@print(@H_502_1@"square.origin is now at (\@H_502_1@(square.origin.x@H_502_1@),\@H_502_1@(square.origin.y@H_502_1@))")
@H_502_1@// 输出@H_502_1@ "square.origin is now at (10.0,10.0)”
@H_502_1@
//@H_502_1@这个例子定义了 3 @H_502_1@个结构体来描述几何形状:
@H_502_1@//Point封装了一个@H_502_1@(x,y)的坐标
@H_502_1@//Size封装了一个@H_502_1@width和一个@H_502_1@height
//Rect@H_502_1@表示一个有原点和尺寸的矩形
//Rect@H_502_1@也提供了一个名为 center @H_502_1@的计算属性。一个矩形的中心点可以从原点( origin )@H_502_1@和尺寸( size )@H_502_1@算 @H_502_1@出,@H_502_1@所以不需要将它以显式声明的 Point @H_502_1@来保存。Rect @H_502_1@的计算属性 center @H_502_1@提供了自定义的 getter @H_502_1@和 setter @H_502_1@来 @H_502_1@获取和设置矩形的中心点,@H_502_1@就像它有一个存储属性一样。
@H_502_1@
//@H_502_1@如果计算属性的 setter @H_502_1@没有定义表示新值的参数名,@H_502_1@则可以使用默认名称 newValue @H_502_1@。下面是使用了便捷 sette r @H_502_1@声明的 Rect @H_502_1@结构体代码:
struct@H_502_1@ AlternativeRect {
@H_502_1@ var@H_502_1@ origin = Point@H_502_1@()
@H_502_1@ var@H_502_1@ size = Size@H_502_1@()
@H_502_1@ var@H_502_1@ center: Point@H_502_1@ {
@H_502_1@ let@H_502_1@ centerX = origin@H_502_1@.x@H_502_1@ + (size@H_502_1@.width@H_502_1@ / 2@H_502_1@)
@H_502_1@ let@H_502_1@ centerY = origin@H_502_1@.y@H_502_1@ + (size@H_502_1@.height@H_502_1@ / 2@H_502_1@)
@H_502_1@ return@H_502_1@ Point@H_502_1@(x: centerX,y: centerY)
@H_502_1@ }
@H_502_1@ origin@H_502_1@.x@H_502_1@ = newValue.x@H_502_1@ - (size@H_502_1@.width@H_502_1@ / 2@H_502_1@)
@H_502_1@ origin@H_502_1@.y@H_502_1@ = newValue.y@H_502_1@ - (size@H_502_1@.height@H_502_1@ / 2@H_502_1@)
@H_502_1@ }
@H_502_1@ }
@H_502_1@}
@H_502_1@
//@H_502_1@只有 getter @H_502_1@没有 setter @H_502_1@的计算属性就是只读计算属性。只读计算属性总是返回一个值,@H_502_1@可以通过点运算符访 @H_502_1@问,@H_502_1@但不能设置新的值。
//@H_502_1@注意:@H_502_1@必须使用 var @H_502_1@关键字定义计算属性,@H_502_1@包括只读计算属性,@H_502_1@因为它们的值不是固定的。 let @H_502_1@关键字只用来声明常 @H_502_1@量属性,@H_502_1@表示初始化后再也无法修改的值。
@H_502_1@
//@H_502_1@只读计算属性的声明可以去掉 get @H_502_1@关键字和花括号:
struct@H_502_1@ Cuboid {
@H_502_1@ var@H_502_1@ width = 0.0@H_502_1@,height = 0.0@H_502_1@,depth = 0.0
@H_502_1@ var@H_502_1@ volume: Double@H_502_1@ {
@H_502_1@ return@H_502_1@ width@H_502_1@ * height@H_502_1@ * depth
@H_502_1@ }
@H_502_1@}
var@H_502_1@ fourByFiveByTwo = Cuboid@H_502_1@(width: 4.0@H_502_1@,height: 5.0@H_502_1@,depth: 2.0@H_502_1@)
@H_481_502@print(@H_502_1@"the volume of fourByFiveByTwo is \@H_502_1@(fourByFiveByTwo.volume@H_502_1@)")
@H_502_1@fourByFiveByTwo.@H_502_1@width = 50
@H_481_502@print(@H_502_1@"the volume of fourByFiveByTwo is \@H_502_1@(fourByFiveByTwo.volume@H_502_1@)")
@H_502_1@// 输出@H_502_1@ "the volume of fourByFiveByTwo is 40.0"
@H_502_1@
@H_502_1@
@H_502_1@
@H_502_1@/*属性观察器@H_502_1@************************************************************/
//@H_502_1@属性观察器监控和响应属性值的变化,@H_502_1@每次属性被设置值的时候都会调用属性观察器,@H_502_1@甚至新的值和现在的值相同的时候也不例外。
//@H_502_1@可以为属性添加如下的一个或全部观察器:
@H_502_1@//? willSet 在新的值被设置之前调用
//? didSet @H_502_1@在新的值被设置之后立即调用
@H_502_1@
//@H_502_1@这里是一个 willSet @H_502_1@和 didSet @H_502_1@的实际例子,@H_502_1@其中定义了一个名为 StepCounter @H_502_1@步数。这个类可以跟计步器或其他日常锻炼的统计装置的输入数据配合使用。
class@H_502_1@ StepCounter {
@H_502_1@ var@H_502_1@ totalSteps: Int@H_502_1@ = 0@H_502_1@ {
@H_502_1@ willSet@H_502_1@(newTotalSteps) {
@H_481_502@print(@H_502_1@"About to set totalSteps to \@H_502_1@(newTotalSteps@H_502_1@)")
@H_502_1@ }
@H_502_1@ if@H_502_1@ totalSteps@H_502_1@ > oldValue {
@H_502_1@ @H_481_502@print@H_502_1@("Added @H_502_1@\(totalSteps@H_502_1@ - oldValue) steps"@H_502_1@)
@H_502_1@ }
@H_502_1@ }
@H_502_1@ }
@H_502_1@}
let@H_502_1@ stepCounter = StepCounter@H_502_1@()
@H_502_1@stepCounter.@H_502_1@totalSteps = 200
@H_502_1@// About to set totalSteps to 200
@H_502_1@// Added 200 steps
@H_502_1@stepCounter.@H_502_1@totalSteps = 360
@H_502_1@// About to set totalSteps to 360
@H_502_1@// Added 160 steps
@H_502_1@stepCounter.@H_502_1@totalSteps = 896
@H_502_1@// About to set totalSteps to 896
@H_502_1@// Added 536 steps
@H_502_1@stepCounter.@H_502_1@totalSteps = 895
@H_502_1@// About to set totalSteps to 895
@H_502_1@
@H_502_1@
@H_502_1@
@H_502_1@/*全局变量和局部变量@H_502_1@************************************************************/
//@H_502_1@计算属性和属性观察器所描述的模式也可以用于全局变量和局部变量。全局变量是在函数、方法、闭包或任何类型之外定义的变量。局部变量是在函数、方法或闭包内部定义的变量
//@H_502_1@注意:@H_502_1@全局的常量或变量都是延迟计算的,@H_502_1@跟延迟存储属性相似,@H_502_1@不同的地方在于,@H_502_1@全局的常量或变量不需要标记 lazy @H_502_1@特性。局部范围的常量或变量不会延迟计算。
@H_502_1@
@H_502_1@
@H_502_1@
@H_502_1@/*类型属性@H_502_1@************************************************************/
//@H_502_1@实例的属性属于一个特定类型实例,@H_502_1@每次类型实例化后都拥有自己的一套属性值,@H_502_1@实例之间的属性相互独立。也可以为类型本身定义属性,@H_502_1@不管类型有多少个实例,@H_502_1@这些属性都只有唯一一份。这种属性就是类型属性。
//@H_502_1@在 C @H_502_1@或 Objective-C @H_502_1@中,@H_502_1@与某个类型关联的静态常量和静态变量,@H_502_1@是作为全局(global)@H_502_1@静态变量定义的。但 @H_502_1@是在 Swift @H_502_1@编程语言中,@H_502_1@类型属性是作为类型定义的一部分写在类型最外层的花括号内,@H_502_1@因此它的作用范围也就 @H_502_1@在类型支持的范围内。
//@H_502_1@使用关键字 static @H_502_1@来定义类型属性。在为类(class)@H_502_1@定义计算型类型属性时,@H_502_1@可以使用关键字 class @H_502_1@来支持子 @H_502_1@类对父类的实现进行重写。下面的例子演示了存储型和计算型类型属性的语法:
struct@H_502_1@ SomeStructure {
@H_502_1@ static@H_502_1@ var@H_502_1@ storedTypeProperty = "Some value."
@H_502_1@ static@H_502_1@ var@H_502_1@ computedTypeProperty: Int@H_502_1@ {
@H_502_1@ }
@H_502_1@}
@H_502_1@
enum@H_502_1@ SomeEnumeration {
@H_502_1@ static@H_502_1@ var@H_502_1@ storedTypeProperty = "Some value."
@H_502_1@ static@H_502_1@ var@H_502_1@ computedTypeProperty: Int@H_502_1@ {
@H_502_1@ }
@H_502_1@}
@H_502_1@
class@H_502_1@ SomeClass {
@H_502_1@ static@H_502_1@ var@H_502_1@ storedTypeProperty = "Some value."
@H_502_1@ static@H_502_1@ var@H_502_1@ computedTypeProperty: Int@H_502_1@ {
@H_502_1@ }
@H_502_1@ class@H_502_1@ var@H_502_1@ overrideableComputedTypeProperty: Int@H_502_1@ {
@H_502_1@ }
@H_502_1@}
//@H_502_1@注意: @H_502_1@例子中的计算型类型属性是只读的,@H_502_1@但也可以定义可读可写的计算型类型属性,@H_502_1@跟实例计算属性的语法类似。
@H_502_1@
@H_481_502@print@H_502_1@(SomeStructure@H_502_1@.storedTypeProperty)
@H_502_1@// 输出@H_502_1@ "Some value."
SomeStructure@H_502_1@.storedTypeProperty = "Another value."
@H_481_502@print@H_502_1@(SomeStructure@H_502_1@.storedTypeProperty)
@H_502_1@// 输出@H_502_1@ "Another value.”
@H_481_502@print@H_502_1@(SomeEnumeration@H_502_1@.computedTypeProperty)
@H_481_502@print@H_502_1@(SomeClass@H_502_1@.computedTypeProperty)
@H_502_1@
@H_502_1@
struct@H_502_1@ AudioChannel {
@H_502_1@ static@H_502_1@ let@H_502_1@ thresholdLevel = 10
@H_502_1@ static@H_502_1@ var@H_502_1@ maxInputLevelForAllChannels = 0
@H_502_1@ var@H_502_1@ currentLevel: Int@H_502_1@ = 0@H_502_1@ {
@H_502_1@ if@H_502_1@ currentLevel@H_502_1@ > AudioChannel@H_502_1@.thresholdLevel {
@H_502_1@ // 将新电平值设置为阀值
@H_502_1@ currentLevel@H_502_1@ = AudioChannel@H_502_1@.thresholdLevel
@H_502_1@ }
@H_502_1@ if@H_502_1@ currentLevel@H_502_1@ > AudioChannel@H_502_1@.maxInputLevelForAllChannels {
@H_502_1@// 存储当前电平值作为新的最大输入电平
@H_502_1@ AudioChannel@H_502_1@.maxInputLevelForAllChannels = currentLevel
@H_502_1@ }
@H_502_1@ }
@H_502_1@ }
@H_502_1@}
//@H_502_1@结构 AudioChannel @H_502_1@定义了 2 @H_502_1@个存储型类型属性来实现上述功能。第一个是 thresholdLevel,@H_502_1@表示声音电平的 @H_502_1@最大上限阈值,@H_502_1@它是一个取值为 10 @H_502_1@的常量,@H_502_1@对所有实例都可见,@H_502_1@如果声音电平高于 10,@H_502_1@则取最大上限值 10(@H_502_1@见后面描述)@H_502_1@。
@H_502_1@//第二个类型属性是变量存储型属性@H_502_1@ maxInputLevelForAllChannels,它用来表示所有@H_502_1@ AudioChannel 实例的电平值的最大值@H_502_1@,初始值是@H_502_1@ 0。
@H_502_1@
//@H_502_1@属性 currentLevel @H_502_1@包含 didSet @H_502_1@属性观察器来检查每次新设置后的属性值,@H_502_1@它有如下两个检查:
@H_502_1@//? 如果@H_502_1@ currentLevel 的新值大于允许的阈值@H_502_1@ thresholdLevel,属性观察器将@H_502_1@ currentLevel 的值限定为阈值@H_502_1@ t hresholdLevel 。
@H_502_1@//? 如果前一个修正后的@H_502_1@ currentLevel 值大于任何之前任意@H_502_1@ AudioChannel 实例中的值@H_502_1@,属性观察器将新值保@H_502_1@ 存在静态类型属性@H_502_1@ maxInputLevelForAllChannels 中。
@H_502_1@
var@H_502_1@ leftChannel = AudioChannel@H_502_1@()
var@H_502_1@ rightChannel = AudioChannel@H_502_1@()
@H_502_1@leftChannel.@H_502_1@currentLevel = 7
@H_481_502@print(@H_502_1@"leftChannel.currentLevel is \@H_502_1@(leftChannel.currentLevel@H_502_1@)")
@H_481_502@print(@H_502_1@"AudioChannel.maxInputLevelForAllChannels is \@H_502_1@(AudioChannel.maxInputLevelForAllChannels@H_502_1@)")
@H_502_1@
@H_502_1@//如果试图将右声道的电平设置成@H_502_1@ 11,则会将右声道的@H_502_1@ currentLevel 修正到最大值@H_502_1@ 10,同时@H_502_1@ maxInputLevelForAllChannels 的值也会更新到@H_502_1@ 10:
@H_502_1@rightChannel.@H_502_1@currentLevel = 11
@H_481_502@print(@H_502_1@"rightChannel.currentLevel is \@H_502_1@(rightChannel.currentLevel@H_502_1@)")
@H_481_502@print(@H_502_1@"AudioChannel.maxInputLevelForAllChannels is \@H_502_1@(AudioChannel.maxInputLevelForAllChannels@H_502_1@)")