swift--广东麻将v2.0(带胡牌、听牌算法和自动打牌功能)

本程序实现了广东麻将的全部功能：自动摸牌、打牌、碰、杠、听牌、胡牌（其中庄家手动打牌，其它电脑玩家自动打牌)，具体功能有：

1. 系统通过骰子确定庄家，然后发牌，最开始从庄家手动打牌。
2. 可以碰，杠，不能吃牌；没有癞子。只能自摸。
3. 所有玩家自动.碰、杠，在某个玩家打牌时，一旦其它玩家可以碰或杠，则自动跳转到对应玩家进行碰杠再自动判断是否胡牌后再打牌（其中庄家手动打牌），模拟真实情况。其中杠有3种模式：
   • 暗杠（自己牌面摸了4张一样的牌杠）、
   • 明杠（先碰，然后摸了一张同样的杠）、
   • 碰杠（就是自己有3张，其它玩家打了一张而杠）
4. 其它玩家自动摸牌，自动判断是否能杠，是否能胡，然后自动打牌，为了简化，默认“杠”优先，就有同时有杠和胡的话，先杠。
5. 本游戏没有界面，只能在控制台玩，后期需要添加上界面。本程序中的gamePk()其实就是不断地调用其他类的方法，后期改为用户按钮点击事件再调用即可。
6. 本程序是自我学习的一个小程序，代码注释非常清楚，但在架构方面还存在一些问题，自动打牌功能还需要完善，目前还在学习设计模式，后期会继续修改。

运行效果：
开始创建玩家。。。
创建 4 个玩家，玩家创建结束。。。。
创建麻将成功。。。。
10次洗牌结束。。。
2个骰子分别是：2:4,结果是6
庄家是2…
1号玩家牌面是：
[7万]、[7万]、[8万]、[8万]、[8条]、[9条]、[2筒]、[3筒]、[5筒]、[6筒]、[8筒]、[南]、[北]、
2号玩家牌面是：
[1万]、[3万]、[5万]、[8万]、[2条]、[9条]、[1筒]、[1筒]、[1筒]、[7筒]、[东]、[东]、[北]、[中]、
3号玩家牌面是：
[1万]、[3万]、[4万]、[4万]、[7万]、[8万]、[5条]、[3筒]、[4筒]、[5筒]、[9筒]、[发]、[白]、
4号玩家牌面是：
[5万]、[9万]、[4条]、[4条]、[6条]、[7条]、[7条]、[东]、[西]、[中]、[中]、[发]、[白]、
2号玩家请打牌，请输入麻将编号：__
Program ended with exit code: 0

下面代码是项目中hupai.swift中内容，主要是关于胡牌，听牌和自动打牌的算法，其中胡牌和听牌功能都OK，但自动打牌的算法很基础，没有考虑牌面已打的牌和可能剩余的牌，项目完整代码可在此下载，可直接编译通过：
https://download.csdn.net/download/qq_42439742/10715620

设计思路：
// 1.设置4个玩家，位置定义：自己是1，左边是2，对面是3，右边是4
创建以下类：
MaJiang : 麻将父类；
MaJiangNumber : 数字牌类，继承自麻将父类。
MaJiangWind : 风牌类，继承自麻将父类。
MaJiangFactory ： 麻将工厂类，用于生成麻将
MaJiangType ： 枚举类型，设定麻将10种牌型
Tools : 工具类，专门用来进行计算
HuPai : 胡牌类， 实现是否胡牌，听牌和自动打牌的算法
Player ： 描述玩家；
Game：控制游戏流程
每个方法 和属性都有详细注释

// 广东麻将简化版
// Created by terry on 2018/8/21.
// 功能：
// 1.在控制台操作。麻将有东西南北中发白，用2颗骰子。
// 2. 创建一幅麻将并洗牌，丢骰子后根据点数发牌，并显示每个玩家的牌面。按点数确定谁是庄家,
// 3.发牌后，对每人的牌面进行排序并显示出来
// 3.可以碰，杠，不能吃牌；没有癞子。只能自摸。胡牌后显示结果。
// 4. IOS10.13+xcode8编译通过

下面是代码：
其中关于majiang类的定义在本文最后面

/**
 //  HuPai.swift
 //  用于广东麻将的胡牌、听牌和打牌算法
 //  要和主程序完全解耦
 备注：
 对子：2张相同的牌，如1万1万
 顺子：3张连续的牌，如1万2万3万
 暗子：3张同样的牌，如1万1万1万
 暗杠：自己摸了4张同样的牌而杠
 碰杠：自己牌面已有3张同样的牌，有人打了一张同样的牌开杠
 摸杠：自己已经碰了一个暗刻，又摸了1张同样的牌开杠

//本程序使用静态方法，并单独写在本文件HuPai.swift中
 /// 本例采用数组形式存放所有胡牌的可能性，第3版将采用"树"来存放。
 
 使用方法：
1.在主程序中直接调用huPai.Ok_HuPai返回是否胡牌。
 2.在主程序中直接调用huPai.Ok_TingPai返回是否听牌和听哪些牌
 //  Created by terry on 2018/9/17.
 **/
 
class HuPai {
    //禁止实例化，全部使用静态方法
    private init() {   
    }
    
    /// 是否听牌
    ///
    /// - Parameter allCards: 玩家的手牌，可能有碰杠而不是13张
    /// - Returns: 是否听牌； 听牌的数组：哪些牌可以胡
    static   func is_TingPai(allCards:[MaJiang])->(isTingPai:Bool,cards_TingPai:[MaJiang]) {
        
        var cards_TingPai:[MaJiang] = [] //返回听牌的那些牌
        var isTingpai = false // 是否听牌
        let clonePais = creatAllClonePai() //创建一幅单张麻将
        
        //将单张麻将中的每一张牌挨个放进去测试是否胡牌，如果胡牌则可以听牌。
        //一幅完整的牌可以同时听几张牌。
        for clonePai in clonePais {
            var clone_allCards =  allCards //生成一幅完整的14张牌
            clone_allCards.append(clonePai)
            
            if is_HuPai(allCards: clone_allCards) == true {
                isTingpai = true   //只要有一张可以胡，就返回已听牌
                cards_TingPai.append(clonePai) //将这些牌放入听牌数组中
            }
        }
        
        return (isTingpai,cards_TingPai) ///听牌结果
    }
    
    /// 是否胡牌
    ///
    /// - Parameters:
    ///   - allCards: 判断是否胡牌的手牌，可能有碰杠而不是14张

    static func  is_HuPai(allCards:[MaJiang])->Bool {
        
        var sortCards = sort(maJiangs: allCards)  //排序后的牌
        
        let allDuiZhi = getDuiZhi(cards:sortCards)  //所有对子的数组，存放的是对子中的单牌，接下来将逐一删除自己作"将"，剩下的就是3n张牌(0<=n<=4)，必须全部成ABC或AAA
        
        // 如果没有对子，则直接不能胡排
        if  allDuiZhi.isEmpty {
            return false
        }
        
        //如果有对子，删除对子得到的数组
        var yuPai:[MaJiang] = []
        //分别删除对子得到所有的数组
        for oneDuiZhi in allDuiZhi{
            sortCards=sort(maJiangs: allCards)  //重新生成完整的排序后的牌
            yuPai = delDuiZhiPai(duiZhi: oneDuiZhi, allCards: sortCards)
            //12张牌如果全部是顺子或者暗子则胡牌，只要有一种能胡牌，就返回true.如果失败则继续删除下一个对子测试是否能胡
            if isShunZhi_Or_AnZhi(yuPai: yuPai) {
                return true
            }
        }
        return false
    }
    
    
    
    
    /// 12张余牌是否全是顺子或者暗子，递归
    ///
    /// - Parameter newCards: 删除某对对子后的12张牌
    /// - Returns: 是否胡牌
    private static   func isShunZhi_Or_AnZhi(yuPai:[MaJiang]) -> Bool {
        //如果数组为空，则胡牌
        if yuPai.isEmpty {
            return true
        }
        var newYuPai = yuPai //将成为暗子或顺子的牌删除后的新余牌
        //由第1，2，3组成一个临时数组，用于计算是否暗子或者顺子，如果是则删除自己，如果都不是，则返回false
        let cards_3 = [yuPai[0],yuPai[1],yuPai[2]]
        if isShunZhi(cards: cards_