调整 Properties 章节细节 (#856)

This commit is contained in:
Damonwong
2019-01-18 09:45:19 +08:00
committed by Jie Liang
parent 3529a8c94b
commit 85b457b8ca

View File

@ -1,10 +1,10 @@
# 属性 # 属性
*属性*将值特定的类、结构或枚举关联。存储属性存储常量变量为实例的一部分,而计算属性计算(不是存储)一个值。计算属性可以用于类、结构体和枚举,存储属性只能用于类和结构体。 *属性*将值特定的类、结构或枚举关联。存储属性会将常量变量存储为实例的一部分,而计算属性则是直接计算(不是存储)值。计算属性可以用于类、结构体和枚举,存储属性只能用于类和结构体。
存储属性和计算属性通常与特定类型的实例关联。但是,属性也可以直接作用于类型本身,这种属性称为类型属性。 存储属性和计算属性通常与特定类型的实例关联。但是,属性也可以直接类型本身关联,这种属性称为类型属性。
另外,还可以定义属性观察器来监控属性值的变化,以此来触发一个自定义的操作。属性观察器可以添加到自己定义的存储属性上,也可以添加到从父类继承的属性上。 另外,还可以定义属性观察器来监控属性值的变化,以此来触发自定义的操作。属性观察器可以添加到类本身定义的存储属性上,也可以添加到从父类继承的属性上。
<a name="stored_properties"></a> <a name="stored_properties"></a>
## 存储属性 ## 存储属性
@ -13,7 +13,7 @@
可以在定义存储属性的时候指定默认值,请参考[默认构造器](./14_Initialization.html#default_initializers)一节。也可以在构造过程中设置或修改存储属性的值,甚至修改常量存储属性的值,请参考[构造过程中常量属性的修改](./14_Initialization.html#assigning_constant_properties_during_initialization)一节。 可以在定义存储属性的时候指定默认值,请参考[默认构造器](./14_Initialization.html#default_initializers)一节。也可以在构造过程中设置或修改存储属性的值,甚至修改常量存储属性的值,请参考[构造过程中常量属性的修改](./14_Initialization.html#assigning_constant_properties_during_initialization)一节。
下面的例子定义了一个名为 `FixedLengthRange` 的结构体,该结构体用于描述整数的范围,且这个范围值在被创建后不能被修改。 下面的例子定义了一个名为 `FixedLengthRange` 的结构体,该结构体用于描述整数的区间,且这个范围值在被创建后不能被修改。
```swift ```swift
struct FixedLengthRange { struct FixedLengthRange {
@ -26,38 +26,38 @@ rangeOfThreeItems.firstValue = 6
// 该区间现在表示整数678 // 该区间现在表示整数678
``` ```
`FixedLengthRange` 的实例包含一个名为 `firstValue` 的变量存储属性和一个名为 `length` 的常量存储属性。在上面的例子中,`length` 在创建实例的时候被初始化,因为它是一个常量存储属性,所以之后无法修改它的值 `FixedLengthRange` 的实例包含一个名为 `firstValue` 的变量存储属性和一个名为 `length` 的常量存储属性。在上面的例子中,`length` 在创建实例的时候被初始化,且之后无法修改它的值,因为它是一个常量存储属性。
<a name="stored_properties_of_constant_structure_instances"></a> <a name="stored_properties_of_constant_structure_instances"></a>
### 常量结构体的存储属性 ### 常量结构体实例的存储属性
如果创建了一个结构体实例并将其赋值给一个常量,则无法修改该实例的任何属性,即使有属性被声明为变量也不行 如果创建了一个结构体实例并将其赋值给一个常量,则无法修改该实例的任何属性,即使被声明为可变属性也不行:
```swift ```swift
let rangeOfFourItems = FixedLengthRange(firstValue: 0, length: 4) let rangeOfFourItems = FixedLengthRange(firstValue: 0, length: 4)
// 该区间表示整数0123 // 该区间表示整数0123
rangeOfFourItems.firstValue = 6 rangeOfFourItems.firstValue = 6
// 尽管 firstValue 是个变属性,这里还是会报错 // 尽管 firstValue 是个变属性,这里还是会报错
``` ```
因为 `rangeOfFourItems` 被声明成了常量(用 `let` 关键字),即使 `firstValue` 是一个变属性,也无法再修改它了。 因为 `rangeOfFourItems` 被声明成了常量(用 `let` 关键字),所以即使 `firstValue` 是一个变属性,也无法再修改它了。
这种行为是由于结构体struct属于*值类型*。当值类型的实例被声明为常量的时候,它的所有属性也就成了常量。 这种行为是由于结构体属于*值类型*。当值类型的实例被声明为常量的时候,它的所有属性也就成了常量。
属于*引用类型*的类class则不一样。把一个引用类型的实例赋给一个常量后,然可以修改该实例的变属性。 属于*引用类型*的类则不一样。把一个引用类型的实例赋给一个常量后,然可以修改该实例的变属性。
<a name="lazy_stored_properties"></a> <a name="lazy_stored_properties"></a>
### 延存储属性 ### 延时加载存储属性
*延存储属性*是指当第一次被调用的时候才会计算其初始值的属性。在属性声明前使用 `lazy` 来标示一个延存储属性。 *延时加载存储属性*是指当第一次被调用的时候才会计算其初始值的属性。在属性声明前使用 `lazy` 来标示一个延时加载存储属性。
> 注意 > 注意
> >
> 必须将延迟存储属性声明成变量(使用 `var` 关键字),因为属性的初始值可能在实例构造完成之后才会得到。而常量属性在构造过程完成之前必须要有初始值,因此无法声明成延迟属性 > 必须将延时加载属性声明成变量(使用 `var` 关键字),因为属性的初始值可能在实例构造完成之后才会得到。而常量属性在构造过程完成之前必须要有初始值,因此无法声明成延时加载
延迟属性很有用,当属性的值依赖于在实例的构造过程结束后才会知道影响值的外部因素时,或者当获得属性的初始值需要复杂或大量计算时,可以只在需要的时候计算 当属性的值依赖于一些外部因素且这些外部因素只有在构造过程结束后才会知道的时候,延时加载属性就会很有用。或者当获得属性的值因为需要复杂或大量计算,而需要采用需要的时候计算的方式,延时加载属性也会很有用
下面的例子使用了延存储属性来避免复杂类中不必要的初始化。例子中定义了 `DataImporter``DataManager` 两个类,下面是部分代码: 下面的例子使用了延时加载存储属性来避免复杂类中不必要的初始化工作。例子中定义了 `DataImporter``DataManager` 两个类,下面是部分代码:
```swift ```swift
class DataImporter { class DataImporter {
@ -81,13 +81,13 @@ manager.data.append("Some more data")
// DataImporter 实例的 importer 属性还没有被创建 // DataImporter 实例的 importer 属性还没有被创建
``` ```
`DataManager` 类包含一个名为 `data` 的存储属性,初始值是一个空的字符串`String`数组。这里没有给出全部代码,只需知道 `DataManager` 类的目的是管理和提供对这个字符串数组的访问即可。 `DataManager` 类包含一个名为 `data` 的存储属性,初始值是一个空的字符串数组。这里没有给出全部代码,只需知道 `DataManager` 类的目的是管理和提供对这个字符串数组的访问即可。
`DataManager` 的一个功能是从文件导入数据。功能由 `DataImporter` 类提供,`DataImporter` 完成初始化需要消耗不少时间:因为它的实例在初始化时可能要打开文件,还要读取文件内容到内存。 `DataManager` 的一个功能是从文件导入数据。这个功能由 `DataImporter` 类提供,`DataImporter` 完成初始化需要消耗不少时间:因为它的实例在初始化时可能要打开文件读取文件中的内容到内存
`DataManager` 管理数据时也可能不从文件中导入数据。所以当 `DataManager` 的实例被创建时,没必要创建一个 `DataImporter` 的实例,更明智的做法是第一次用到 `DataImporter` 的时候才去创建它。 `DataManager` 管理数据时也可能不从文件中导入数据。所以当 `DataManager` 的实例被创建时,没必要创建一个 `DataImporter` 的实例,更明智的做法是第一次用到 `DataImporter` 的时候才去创建它。
由于使用了 `lazy``importer` 属性只有在第一次被访问的时候才被创建。比如访问它的属性 `fileName` 时: 由于使用了 `lazy``DataImporter` 的实例 `importer` 属性只有在第一次被访问的时候才被创建。比如访问它的属性 `fileName` 时:
```swift ```swift
print(manager.importer.fileName) print(manager.importer.fileName)
@ -102,9 +102,9 @@ print(manager.importer.fileName)
<a name="stored_properties_and_instance_variables"></a> <a name="stored_properties_and_instance_variables"></a>
### 存储属性和实例变量 ### 存储属性和实例变量
如果您有过 Objective-C 经验,应该知道 Objective-C 为类实例存储值和引用提供两种方法。除了属性之外,还可以使用实例变量作为属性值的后端存储 如果您有过 Objective-C 经验,应该知道 Objective-C 为类实例存储值和引用提供两种方法。除了属性之外,还可以使用实例变量作为一个备份存储将变量值赋值给属性。
Swift 编程语言中把这些理论统一用属性来实现。Swift 中的属性没有对应的实例变量,属性的后端存储也无法直接访问。这就避免了不同场景下访问方式的困扰,同时也将属性的定义简化成一个语句。属性的全部信息——包括命名、类型和内存管理特征——作为类型定义的一部分,都定义在一个地方。 Swift 编程语言中把这些理论统一用属性来实现。Swift 中的属性没有对应的实例变量,属性的备份存储也无法直接访问。这就避免了不同场景下访问方式的困扰,同时也将属性的定义简化成一个语句。属性的全部信息——包括命名、类型和内存管理特征——作为类型定义的一部分,都定义在一个地方。
<a name="computed_properties"></a> <a name="computed_properties"></a>
## 计算属性 ## 计算属性
@ -138,7 +138,7 @@ var square = Rect(origin: Point(x: 0.0, y: 0.0),
let initialSquareCenter = square.center let initialSquareCenter = square.center
square.center = Point(x: 15.0, y: 15.0) square.center = Point(x: 15.0, y: 15.0)
print("square.origin is now at (\(square.origin.x), \(square.origin.y))") print("square.origin is now at (\(square.origin.x), \(square.origin.y))")
// 打印square.origin is now at (10.0, 10.0)” // 打印 "square.origin is now at (10.0, 10.0)”
``` ```
这个例子定义了 3 个结构体来描述几何形状: 这个例子定义了 3 个结构体来描述几何形状:
@ -147,7 +147,7 @@ print("square.origin is now at (\(square.origin.x), \(square.origin.y))")
- `Size` 封装了一个 `width` 和一个 `height` - `Size` 封装了一个 `width` 和一个 `height`
- `Rect` 表示一个有原点和尺寸的矩形 - `Rect` 表示一个有原点和尺寸的矩形
`Rect` 也提供了一个名为 `center` 的计算属性。一个矩形的中心点可以从原点(`origin`)和大小`size`)算出,所以不需要将它以显式声明的 `Point` 来保存。`Rect` 的计算属性 `center` 提供了自定义的 getter 和 setter 来获取和设置矩形的中心点,就像它有一个存储属性一样。 `Rect` 也提供了一个名为 `center` 的计算属性。一个 `Rect` 的中心点可以从 `origin`原点)和 `size`(大小)算出,所以不需要将中心点以 `Point` 类型的值来保存。`Rect` 的计算属性 `center` 提供了自定义的 getter 和 setter 来获取和设置矩形的中心点,就像它有一个存储属性一样。
上述例子中创建了一个名为 `square``Rect` 实例,初始值原点是 `(0, 0)`,宽度高度都是 `10`。如下图中蓝色正方形所示。 上述例子中创建了一个名为 `square``Rect` 实例,初始值原点是 `(0, 0)`,宽度高度都是 `10`。如下图中蓝色正方形所示。
@ -183,7 +183,7 @@ struct AlternativeRect {
<a name="readonly_computed_properties"></a> <a name="readonly_computed_properties"></a>
### 只读计算属性 ### 只读计算属性
只有 getter 没有 setter 的计算属性就是*只读计算属性*。只读计算属性总是返回一个值,可以通过点运算符访问,但不能设置新的值。 只有 getter 没有 setter 的计算属性*只读计算属性*。只读计算属性总是返回一个值,可以通过点运算符访问,但不能设置新的值。
> 注意 > 注意
> >
@ -200,7 +200,7 @@ struct Cuboid {
} }
let fourByFiveByTwo = Cuboid(width: 4.0, height: 5.0, depth: 2.0) let fourByFiveByTwo = Cuboid(width: 4.0, height: 5.0, depth: 2.0)
print("the volume of fourByFiveByTwo is \(fourByFiveByTwo.volume)") print("the volume of fourByFiveByTwo is \(fourByFiveByTwo.volume)")
// 打印the volume of fourByFiveByTwo is 40.0 // 打印 "the volume of fourByFiveByTwo is 40.0"
``` ```
这个例子定义了一个名为 `Cuboid` 的结构体,表示三维空间的立方体,包含 `width``height``depth` 属性。结构体还有一个名为 `volume` 的只读计算属性用来返回立方体的体积。为 `volume` 提供 setter 毫无意义,因为无法确定如何修改 `width``height``depth` 三者的值来匹配新的 `volume`。然而,`Cuboid` 提供一个只读计算属性来让外部用户直接获取体积是很有用的。 这个例子定义了一个名为 `Cuboid` 的结构体,表示三维空间的立方体,包含 `width``height``depth` 属性。结构体还有一个名为 `volume` 的只读计算属性用来返回立方体的体积。为 `volume` 提供 setter 毫无意义,因为无法确定如何修改 `width``height``depth` 三者的值来匹配新的 `volume`。然而,`Cuboid` 提供一个只读计算属性来让外部用户直接获取体积是很有用的。
@ -210,22 +210,22 @@ print("the volume of fourByFiveByTwo is \(fourByFiveByTwo.volume)")
属性观察器监控和响应属性值的变化,每次属性被设置值的时候都会调用属性观察器,即使新值和当前值相同的时候也不例外。 属性观察器监控和响应属性值的变化,每次属性被设置值的时候都会调用属性观察器,即使新值和当前值相同的时候也不例外。
你可以为除了延存储属性之外的其他存储属性添加属性观察器,也可以通过重写属性的方式为继承的属性(包括存储属性和计算属性)添加属性观察器。你不必为非重写的计算属性添加属性观察器,因为可以通过它的 setter 直接监控和响应值的变化。 属性重写请参考[重写](./13_Inheritance.html#overriding)。 你可以为除了延时加载存储属性之外的其他存储属性添加属性观察器,也可以在子类中通过重写属性的方式为继承的属性(包括存储属性和计算属性)添加属性观察器。你不必为非重写的计算属性添加属性观察器,因为可以直接通过它的 setter 监控和响应值的变化。属性重写请参考[重写](./13_Inheritance.html#overriding)。
可以为属性添加如下的一个或全部观察器: 可以为属性添加其中一个或两个观察器:
- `willSet` 在新的值被设置之前调用 - `willSet` 在新的值被设置之前调用
- `didSet` 在新的值被设置之后立即调用 - `didSet` 在新的值被设置之后调用
`willSet` 观察器会将新的属性值作为常量参数传入,在 `willSet` 的实现代码中可以为这个参数指定一个名称,如果不指定则参数仍然可用,这时使用默认名称 `newValue` 表示。 `willSet` 观察器会将新的属性值作为常量参数传入,在 `willSet` 的实现代码中可以为这个参数指定一个名称,如果不指定则参数仍然可用,这时使用默认名称 `newValue` 表示。
同样,`didSet` 观察器会将旧的属性值作为参数传入,可以为该参数命名或者使用默认参数名 `oldValue`。如果在 `didSet` 方法中再次对该属性赋值,那么新值会覆盖旧的值。 同样,`didSet` 观察器会将旧的属性值作为参数传入,可以为该参数指定一个名称或者使用默认参数名 `oldValue`。如果在 `didSet` 方法中再次对该属性赋值,那么新值会覆盖旧的值。
> 注意 > 注意
> >
> 父类的属性在子类构造器中被赋值时,它在父类中的 `willSet` 和 `didSet` 观察器会被调用,随后才会调用子类的观察器。在父类初始化方法调用之前,子类属性赋值时,观察器不会调用。 > 在父类初始化方法调用之后,在子类构造器中给父类的属性赋值时,会调用父类属性的 `willSet` 和 `didSet` 观察器。在父类初始化方法调用之前,子类属性赋值时不会调用子类属性的观察器
> >
> 有关构造器代理的更多信息,请参考[值类型的构造器代理](./14_Initialization.html#initializer_delegation_for_value_types)和[类的构造器代理规则](./14_Initialization.html#initializer_delegation_for_class_types)。 > 有关构造器代理的更多信息,请参考[值类型的构造器代理](./14_Initialization.html#initializer_delegation_for_value_types)和[类的构造器代理](./14_Initialization.html#initializer_delegation_for_class_types)。
下面是一个 `willSet``didSet` 实际运用的例子,其中定义了一个名为 `StepCounter` 的类,用来统计一个人步行时的总步数。这个类可以跟计步器或其他日常锻炼的统计装置的输入数据配合使用。 下面是一个 `willSet``didSet` 实际运用的例子,其中定义了一个名为 `StepCounter` 的类,用来统计一个人步行时的总步数。这个类可以跟计步器或其他日常锻炼的统计装置的输入数据配合使用。
@ -233,28 +233,28 @@ print("the volume of fourByFiveByTwo is \(fourByFiveByTwo.volume)")
class StepCounter { class StepCounter {
var totalSteps: Int = 0 { var totalSteps: Int = 0 {
willSet(newTotalSteps) { willSet(newTotalSteps) {
print("About to set totalSteps to \(newTotalSteps)") print(" totalSteps 的值设置为 \(newTotalSteps)")
} }
didSet { didSet {
if totalSteps > oldValue { if totalSteps > oldValue {
print("Added \(totalSteps - oldValue) steps") print("增加了 \(totalSteps - oldValue) ")
} }
} }
} }
} }
let stepCounter = StepCounter() let stepCounter = StepCounter()
stepCounter.totalSteps = 200 stepCounter.totalSteps = 200
// About to set totalSteps to 200 // totalSteps 的值设置为 200
// Added 200 steps // 增加了 200 步
stepCounter.totalSteps = 360 stepCounter.totalSteps = 360
// About to set totalSteps to 360 // totalSteps 的值设置为 360
// Added 160 steps // 增加了 160 步
stepCounter.totalSteps = 896 stepCounter.totalSteps = 896
// About to set totalSteps to 896 // totalSteps 的值设置为 896
// Added 536 steps // 增加了 536 步
``` ```
`StepCounter` 类定义了一个 `Int` 类型的属性 `totalSteps`它是一个存储属性,包含 `willSet``didSet` 观察器。 `StepCounter` 类定义了一个 `totalSteps``Int` 类型的属性。它是一个存储属性,包含 `willSet``didSet` 观察器。
`totalSteps` 被设置新值的时候,它的 `willSet``didSet` 观察器都会被调用,即使新值和当前值完全相同时也会被调用。 `totalSteps` 被设置新值的时候,它的 `willSet``didSet` 观察器都会被调用,即使新值和当前值完全相同时也会被调用。
@ -264,12 +264,12 @@ stepCounter.totalSteps = 896
> 注意 > 注意
> >
> 如果将属性通过 in-out 方式传入函数,`willSet` 和 `didSet` 也会调用。这是因为 in-out 参数采用了拷入拷出模式:即在函数内部使用的是参数的 copy函数结束后又对参数重新赋值。关于 in-out 参数详细的介绍,请参考[输入输出参数](../chapter3/05_Declarations.html#in-out_parameters) > 如果将带有观察器的属性通过 in-out 方式传入函数,`willSet` 和 `didSet` 也会调用。这是因为 in-out 参数采用了拷入拷出内存模式:即在函数内部使用的是参数的 copy函数结束后又对参数重新赋值。关于 in-out 参数详细的介绍,请参考[输入输出参数](../chapter3/05_Declarations.html#in-out_parameters)
<a name="global_and_local_variables"></a> <a name="global_and_local_variables"></a>
## 全局变量和局部变量 ## 全局变量和局部变量
计算属性和属性观察器所描述的功能也可以用于*全局变量*和*局部变量*。全局变量是在函数、方法、闭包或任何类型之外定义的变量。局部变量是在函数、方法或闭包内部定义的变量。 计算属性和观察属性所描述的功能也可以用于*全局变量*和*局部变量*。全局变量是在函数、方法、闭包或任何类型之外定义的变量。局部变量是在函数、方法或闭包内部定义的变量。
前面章节提到的全局或局部变量都属于*存储型变量*,跟存储属性类似,它为特定类型的值提供存储空间,并允许读取和写入。 前面章节提到的全局或局部变量都属于*存储型变量*,跟存储属性类似,它为特定类型的值提供存储空间,并允许读取和写入。
@ -277,16 +277,16 @@ stepCounter.totalSteps = 896
> 注意 > 注意
> >
> 全局的常量或变量都是延迟计算的,跟[延存储属性](#lazy_stored_properties)相似,不同的地方在于,全局的常量或变量不需要标记 `lazy` 修饰符。 > 全局的常量或变量都是延迟计算的,跟[延时加载存储属性](#lazy_stored_properties)相似,不同的地方在于,全局的常量或变量不需要标记 `lazy` 修饰符。
> >
> 局部范围的常量变量从不延迟计算。 > 局部范围的常量变量从不延迟计算。
<a name="type_properties"></a> <a name="type_properties"></a>
## 类型属性 ## 类型属性
实例属性属于一个特定类型的实例,每创建一个实例,实例都拥有属于自己的一套属性值,实例之间的属性相互独立。 实例属性属于一个特定类型的实例,每创建一个实例,实例都拥有属于自己的一套属性值,实例之间的属性相互独立。
也可以为类型本身定义属性,无论创建了多少个该类型的实例,这些属性都只有唯一一份。这种属性就是*类型属性*。 也可以为类型本身定义属性,无论创建了多少个该类型的实例,这些属性都只有唯一一份。这种属性就是*类型属性*。
类型属性用于定义某个类型所有实例共享的数据,比如*所有*实例都能用的一个常量(就像 C 语言中的静态常量),或者所有实例都能访问的一个变量(就像 C 语言中的静态变量)。 类型属性用于定义某个类型所有实例共享的数据,比如*所有*实例都能用的一个常量(就像 C 语言中的静态常量),或者所有实例都能访问的一个变量(就像 C 语言中的静态变量)。
@ -301,7 +301,7 @@ stepCounter.totalSteps = 896
<a name="type_property_syntax"></a> <a name="type_property_syntax"></a>
### 类型属性语法 ### 类型属性语法
在 C 或 Objective-C 中,与某个类型关联的静态常量和静态变量,是作为全局(*global*)静态变量定义的。但是在 Swift 中,类型属性是作为类型定义的一部分写在类型最外层的花括号内,因此它的作用范围也就在类型支持的范围内。 在 C 或 Objective-C 中,与某个类型关联的静态常量和静态变量,是作为 *global*(全局)静态变量定义的。但是在 Swift 中,类型属性是作为类型定义的一部分写在类型最外层的花括号内,因此它的作用范围也就在类型支持的范围内。
使用关键字 `static` 来定义类型属性。在为类定义计算型类型属性时,可以改用关键字 `class` 来支持子类对父类的实现进行重写。下面的例子演示了存储型和计算型类型属性的语法: 使用关键字 `static` 来定义类型属性。在为类定义计算型类型属性时,可以改用关键字 `class` 来支持子类对父类的实现进行重写。下面的例子演示了存储型和计算型类型属性的语法:
@ -336,18 +336,18 @@ class SomeClass {
<a name="querying_and_setting_type_properties"></a> <a name="querying_and_setting_type_properties"></a>
### 获取和设置类型属性的值 ### 获取和设置类型属性的值
跟实例属性一样,类型属性也是通过点运算符来访问。但是,类型属性是通过类型本身来访问,而不是通过实例。比如: 跟实例属性一样,类型属性也是通过点运算符来访问。但是,类型属性是通过*类型*本身来访问,而不是通过实例。比如:
```swift ```swift
print(SomeStructure.storedTypeProperty) print(SomeStructure.storedTypeProperty)
// 打印Some value. // 打印 "Some value."
SomeStructure.storedTypeProperty = "Another value." SomeStructure.storedTypeProperty = "Another value."
print(SomeStructure.storedTypeProperty) print(SomeStructure.storedTypeProperty)
// 打印Another value.” // 打印 "Another value.”
print(SomeEnumeration.computedTypeProperty) print(SomeEnumeration.computedTypeProperty)
// 打印“6” // 打印 "6"
print(SomeClass.computedTypeProperty) print(SomeClass.computedTypeProperty)
// 打印27 // 打印 "27"
``` ```
下面的例子定义了一个结构体,使用两个存储型类型属性来表示两个声道的音量,每个声道具有 `0``10` 之间的整数音量。 下面的例子定义了一个结构体,使用两个存储型类型属性来表示两个声道的音量,每个声道具有 `0``10` 之间的整数音量。
@ -377,9 +377,9 @@ struct AudioChannel {
} }
``` ```
结构 `AudioChannel` 定义了 2 个存储型类型属性来实现上述功能。第一个是 `thresholdLevel`,表示音量的最大上限阈值,它是一个值为 `10` 的常量,对所有实例都可见,如果音量高于 `10`,则取最大上限值 `10`(见后面描述)。 `AudioChannel` 结构定义了 2 个存储型类型属性来实现上述功能。第一个是 `thresholdLevel`,表示音量的最大上限阈值,它是一个值为 `10` 的常量,对所有实例都可见,如果音量高于 `10`,则取最大上限值 `10`(见后面描述)。
第二个类型属性是变量存储型属性 `maxInputLevelForAllChannels`,它用来表示所有 `AudioChannel` 实例的最大音量,初始值是 `0` 第二个类型属性是变量存储型属性 `maxInputLevelForAllChannels`,它用来表示所有 `AudioChannel` 实例的最大输入音量,初始值是 `0`
`AudioChannel` 也定义了一个名为 `currentLevel` 的存储型实例属性,表示当前声道现在的音量,取值为 `0``10` `AudioChannel` 也定义了一个名为 `currentLevel` 的存储型实例属性,表示当前声道现在的音量,取值为 `0``10`