21.1. 嵌套类型实践

下面这个例子定义了一个结构体 BlackjackCard(二十一点),用来模拟 BlackjackCard 中的扑克牌点数。BlackjackCard 结构体包含两个嵌套定义的枚举类型 SuitRank

BlackjackCard 中,Ace 牌可以表示 1 或者 11Ace 牌的这一特征通过一个嵌套在 Rank 枚举中的结构体 Values 来表示:

struct BlackjackCard {
    // 嵌套的 Suit 枚举
    enum Suit: Character {
        case spades = "♠", hearts = "♡", diamonds = "♢", clubs = "♣"
    }
    // 嵌套的 Rank 枚举
    enum Rank: Int {
        case two = 2, three, four, five, six, seven, eight, nine, ten
        case jack, queen, king, ace
        struct Values {
            let first: Int, second: Int?
        }
        var values: Values {
            switch self {
            case .ace:
                return Values(first: 1, second: 11)
            case .jack, .queen, .king:
                return Values(first: 10, second: nil)
            default:
                return Values(first: self.rawValue, second: nil)
            }
        }
    }
    // BlackjackCard 的属性和方法
    let rank: Rank, suit: Suit
    var description: String {
        var output = "suit is \(suit.rawValue),"
        output += " value is \(rank.values.first)"
        if let second = rank.values.second {
            output += " or \(second)"
        }
        return output
    }
}

Suit 枚举用来描述扑克牌的四种花色,并用一个 Character 类型的原始值表示花色符号。

Rank 枚举用来描述扑克牌从 Ace~10,以及 JQK,这 13 种牌,并用一个 Int 类型的原始值表示牌的面值。(这个 Int 类型的原始值未用于 AceJQK4 种牌。)

如上所述,Rank 枚举在内部定义了一个嵌套结构体 Values。结构体 Values 中定义了两个属性,用于反映只有 Ace 有两个数值,其余牌都只有一个数值:

  • first 的类型为 Int
  • second 的类型为 Int?,或者说“可选 Int

Rank 还定义了一个计算型属性 values,它将会返回一个 Values 结构体的实例。这个计算型属性会根据牌的面值,用适当的数值去初始化 Values 实例。对于 JQKAce 这四种牌,会使用特殊数值。对于数字面值的牌,使用枚举实例的 Int 类型的原始值。

BlackjackCard 结构体拥有两个属性——ranksuit。它也同样定义了一个计算型属性 descriptiondescription 属性用 ranksuit 中的内容来构建对扑克牌名字和数值的描述。该属性使用可选绑定来检查可选类型 second 是否有值,若有值,则在原有的描述中增加对 second 的描述。

因为 BlackjackCard 是一个没有自定义构造器的结构体,在 结构体的逐一成员构造 中可知,结构体有默认的成员构造器,所以你可以用默认的构造器去初始化新常量 theAceOfSpades

let theAceOfSpades = BlackjackCard(rank: .ace, suit: .spades)
print("theAceOfSpades: \(theAceOfSpades.description)")
// 打印“theAceOfSpades: suit is ♠, value is 1 or 11”

尽管 RankSuit 嵌套在 BlackjackCard 中,但它们的类型仍可从上下文中推断出来,所以在初始化实例时能够单独通过成员名称(.ace.spades)引用枚举实例。在上面的例子中,description 属性正确地反映了黑桃 A 牌具有 111 两个值。