原创干货！麻将平胡算法

此算法基本可以通用于所有麻将的平胡规则，即满足m * ABC + n * AAA + AA（其中m、n可为0）的胡牌公式，红黑字牌也可由此算法演变。

首先，我们要约定每张麻将都可以由一个数字表示，比如11表示一万，12表示二万，21表示一条，22表示二条，31表示一筒，32表示二筒……

即所有牌用两位数表示，表示万条筒的两位数个位为牌点，十位为牌类型，其它表示非字牌的两位数与牌类型相同，以下用一个枚举类定义：

import java.util.HashMap; import java.util.Map; /** * 麻将类型枚举 * * @author zkpursuit */ public enum CardType { wan(1, "万"), tiao(2, "条"), tong(3, "筒"), dong(40, "东风"), nan(41, "南风"), xi(42, "西风"), bei(43, "北风"), zhong(44, "中"), fa(45, "发"), ban(46, "白板"); //类型 private final int value; //牌名 private final String name; private CardType(int value, String name) { this.value = value; this.name = name; } public int getValue() { return value; } public String getName() { return name; } private static final Map<Integer, String> numMap = new HashMap<>(); private static final Map<Integer, CardType> types = new HashMap<>(); private static final Map<Integer, String> typeNames = new HashMap<>(); static { numMap.put(1, "一"); numMap.put(2, "二"); numMap.put(3, "三"); numMap.put(4, "四"); numMap.put(5, "五"); numMap.put(6, "六"); numMap.put(7, "七"); numMap.put(8, "八"); numMap.put(9, "九"); CardType[] enums = CardType.values(); for (CardType cardType : enums) { types.put(cardType.getValue(), cardType); typeNames.put(cardType.getValue(), cardType.getName()); } } /** * 获取牌类型枚举 * * @param typeValue 牌类型值 * @return 牌类型枚举 */ public static final CardType getCardType(int typeValue) { return types.get(typeValue); } /** * 获取牌的类型名 * * @param typeValue 牌类型 * @return 牌类型名 */ public static final String getCardTypeName(int typeValue) { return typeNames.get(typeValue); } /** * 获取牌类型数值表示 * * @param card 牌号 * @return 牌类型数值表示 */ public static final int getCardTypeValue(int card) { if (card < 40) { return HandCards.getCardLeftValue(card); } return card; } /** * 将牌数据转换为现实中可读的牌 * * @param card 牌数据 * @return 现实中可读的牌 */ public static final String getCardName(int card) { if (card < 40) { int type = HandCards.getCardLeftValue(card); int point = HandCards.getCardRightValue(card); StringBuilder sb = new StringBuilder(); sb.append(numMap.get(point)); sb.append(getCardTypeName(type)); return sb.toString(); } return getCardTypeName(card); } }

以上定义了各张牌的数字表示，接下来我们分析手牌的存储结构，手牌可以用一个数组表示，数组下标号能除尽10的数组元素为保留位，不用于存储任何数据。举例解释此数组存储牌的数据结构：

0号下标保留位
1~9号下标为万字牌牌点，其对应的数组元素为牌的张数
10号下标保留位
11~19号下标为条字牌牌点，其对应的数组元素为牌的张数
20号下标为保留位
21~29号下标为筒字牌牌点，其对应的数组元素为牌的张数
40~46号下标分别表示东、南、西、北、中、发、白的存储位。

根据以上的定义，则可以根据数组下标获得万条筒字牌的类型和牌点，(下标/10 + 1) 则为字牌类型，(下标%10) 则为字牌点数。

具体定义一个手牌类，里面定义了各种静态的换算函数，可参看注释。

/** * 手牌 * * @author zkpursuit */ public class HandCards { /** * 获取牌号最左边的一位数，如果牌为筒、条、万，则返回值为牌类型数值 * * @param card 牌号 * @return 牌号从左至右第一位数（十位数） */ public final static int getCardLeftValue(int card) { return card / 10; } /** * 获取牌号最右边的一位数，如果牌为筒、条、万，则返回值为牌点数 * * @param card 牌号 * @return 牌号从右至左第一位数（个位数） */ public final static int getCardRightValue(int card) { return card % 10; } /** * 获取牌号最左边的一位数，如果牌为筒、条、万，则返回值为牌类型数值 * * @param idx 牌在归类数组中的索引位置 * @return 牌号从左至右第一位数（十位数） */ public final static int getCardLeftValueByClusterIndex(int idx) { return idx / 10 + 1; } /** * 获取牌号最右边的一位数，如果牌为筒、条、万，则返回值为牌点数 * * @param idx 牌在归类数组中的索引位置 * @return 牌号从右至左第一位数（个位数） */ public final static int getCardRightValueByClusterIndex(int idx) { return idx % 10; } /** * 根据牌号取得其所在的牌归类数组中的索引 * * @param card 牌号 * @return 牌归类数组中的索引 */ public final static int getClusterIndexByCard(int card) { int left = getCardLeftValue(card); int right = getCardRightValue(card); int idx = (left - 1) * 10 + right; return idx; } /** * 根据十位数和个位数确定牌在聚合数组中的索引位置 * * @param leftValue 十位数 * @param rightValue 个位数 * @return 聚合数组中的索引位置 */ public final static int getClusterIndex(int leftValue, int rightValue) { return (leftValue - 1) * 10 + rightValue; } /** * 归类牌<br> * 数组索引 / 10 + 1 表示牌类型<br> * 数组索引 % 10 表示牌点数<br> * 数组索引位置的值表示牌数量 */ private int[] cardClusterArray; /** * 起始有效的索引位置<br> * 第一个值不为0的索引位置<br> */ private int startIndex; /** * 归类牌数组的有效索引位置，因为有可能后面的位置全是0<br> * 此索引的后续索引位置的值全部为0，即最后一个值不为0的索引位置<br> */ private int lastIndex; /** * 所有的牌数量 */ private int cardTotals; /** * 构造方法 */ public HandCards() { cardClusterArray = new int[40]; startIndex = 1000; lastIndex = -1; cardTotals = 0; } /** * 构造方法 * * @param cards 未归类的牌数组 */ public HandCards(int[] cards) { this(); if (cards != null) { setCards(cards); } } /** * 重置数据 */ public void reset() { if (cardTotals != 0) { int len = getClusterValidLength(); for (int i = 0; i < len; i++) { cardClusterArray[i] = 0; } } startIndex = 1000; lastIndex = -1; cardTotals = 0; } /** * 清除数据 */ public void clear() { reset(); } /** * 重置数据并以传入的牌数据再次初始化数据 * * @param cards 牌数据 */ public final void setCards(int[] cards) { reset(); for (int card : cards) { addCard(card); } } /** * 添加num张牌 * * @param card 添加的牌号 * @param num 添加的数量 * @return true添加成功；false添加失败 */ public boolean addCard(int card, int num) { int idx = getClusterIndexByCard(card); int lastNum = cardClusterArray[idx] + num; if (lastNum > 4) { return false; } cardClusterArray[idx] = lastNum; if (idx > lastIndex) { lastIndex = idx; } if (idx < startIndex) { startIndex = idx; } cardTotals += num; return true; } /** * 添加一张牌 * * @param card 牌号 * @return true添加成功；false添加失败 */ public boolean addCard(int card) { return addCard(card, 1); } /** * 添加牌集合 * * @param cards 牌集合，比如 [11, 23, 33, 33, 33, 34] * @return true添加成功，只要有一张添加失败则全部失败 */ public boolean addCards(int... cards) { for (int card : cards) { int idx = getClusterIndexByCard(card); int lastNum = cardClusterArray[idx] + 1; if (lastNum > 4) { return false; } } for (int card : cards) { addCard(card); } return true; } /** * 移除num张牌 * * @param card 移除的牌号 * @param num 移除的数量 * @return true移除成功；false移除失败 */ public boolean removeCard(int card, int num) { int idx = getClusterIndexByCard(card); if (cardClusterArray[idx] < num) { return false; } cardClusterArray[idx] -= num; if (cardClusterArray[idx] == 0) { if (idx == startIndex) { startIndex = 1000; for (int i = idx; i < cardClusterArray.length; i++) { if (cardClusterArray[i] > 0) { startIndex = i; break; } } } if (lastIndex == idx) { int start = startIndex; if (start >= cardClusterArray.length) { start = 0; } lastIndex = -1; for (int i = idx; i >= start; i--) { if (cardClusterArray[i] > 0) { lastIndex = i; break; } } } } cardTotals -= num; return true; } /** * 移除一张牌 * * @param card 牌号 * @return true移除成功；false移除失败 */ public boolean removeCard(int card) { return removeCard(card, 1); } /** * 移除牌号对应的所有牌 * * @param card 牌号 * @return true移除成功；false移除失败 */ public boolean removeCardOfAll(int card) { int num = getCardNum(card); if (num >= 0) { return removeCard(card, num); } return true; } /** * 移除牌 * * @param cards 需要移除的牌 * @return true表示移除成功，只要有一张牌移除失败则整个失败 */ public boolean removeCards(int... cards) { for (int card : cards) { int idx = getClusterIndexByCard(card); if (cardClusterArray[idx] < 1) { return false; } } for (int card : cards) { removeCard(card); } return true; } /** * 是否有指定的牌 * * @param card 牌号 * @return true表示存在 */ public boolean hasCard(int card) { return getCardNum(card) > 0; } /** * 获取牌号对应的数量 * * @param card 牌号 * @return 牌号对应的数量 */ public int getCardNum(int card) { int idx = getClusterIndexByCard(card); return cardClusterArray[idx]; } /** * 获取归类的牌数据，整除10的索引位置为保留位，不参与任何实际运算<br> * 数组索引从0开始，有效长度（后面全部为0）结束<br> * 此数组为数据副本，其中的任何数据变动都不会改变原数组<br> * 数组索引 / 10 + 1 表示牌类型<br> * 数组索引 % 10 表示牌点数<br> * * @return 归类的牌数据 */ public int[] getCardClusterArray() { int[] array = new int[getClusterValidLength()]; System.arraycopy(cardClusterArray, 0, array, 0, array.length); return array; } /** * 根据提供的索引位置获取牌数量 * * @param idx 牌归类数组中的索引位置 * @return 牌数量 */ public int getCardNumByClusterIndex(int idx) { return cardClusterArray[idx]; } /** * 根据索引位置定位对应的牌 * * @param idx 归类牌数组中的索引位置 * @return -1表示找不到对应的牌，否则返回牌号 */ public int getCardByClusterIndex(int idx) { if (cardClusterArray[idx] <= 0) { return -1; } int left = getCardLeftValueByClusterIndex(idx); int right = getCardRightValueByClusterIndex(idx); return left * 10 + right; } /** * 归类牌数组中起始有效索引 * * @return 起始有效索引，第一个值不为0的索引位置 */ public int getClusterValidStartIndex() { if (cardTotals == 0) { return 1; } return startIndex; } /** * 归类牌数组中最终的有效索引 * * @return 最终有效索引，其后的值全为0 */ public int getClusterValidEndIndex() { return lastIndex; } /** * 归类牌数组的有效长度<br> * 有效的起始索引到有效的最后索引之前的长度<br> * * @return 有效长度，因为归类数组中后面可能有很多无效的0 */ public int getClusterValidLength() { return lastIndex + 1; } /** * 所有牌的张数 * * @return 总张数 */ public int getCardTotals() { return cardTotals; } /** * 获取所有的牌数据，未归类 * * @return 未归类的牌数据，两位数的牌号数组 */ public int[] getCards() { if (cardTotals <= 0) { return null; } int len = getClusterValidLength(); int[] cards = new int[cardTotals]; int idx = 0; for (int i = getClusterValidStartIndex(); i < len; i++) { int left = getCardLeftValueByClusterIndex(i); int right = getCardRightValueByClusterIndex(i); int count = cardClusterArray[i]; int card = left * 10 + right; for (int j = 0; j < count; j++) { cards[idx] = card; idx++; } } return cards; } @Override public HandCards clone() { HandCards copy = new HandCards(); copy.cardTotals = this.cardTotals; copy.lastIndex = this.lastIndex; copy.startIndex = this.startIndex; if (cardClusterArray != null) { int[] copyCardClusterArray = new int[cardClusterArray.length]; System.arraycopy(cardClusterArray, 0, copyCardClusterArray, 0, cardClusterArray.length); copy.cardClusterArray = copyCardClusterArray; } return copy; } }

准备工作都做好了，怎么使用上面定义的数据结构实现平胡算法呢？平胡满足m * ABC + n * AAA + AA（其中m、n可为0）的胡牌公式，分析此公式，AA表示一对牌，则算法必然需要分析手牌中是否含有一对牌，ABC表示三张相同类型且连续的牌，AAA表示三张相同类型且牌点也相同的牌。

依据公式，我们用递归思路编写一个平胡胡牌算法（其中包含简单的测试用例）：

import java.util.Arrays; /** * * @author zkpursuit */ public final class AI { /** * 递归方式判断平胡 * * @param cardClusterArray 牌号和牌数量的簇集对象集合 * @param len 所有牌数量 * @return true表示可以胡牌 */ private static boolean isPingHu(int[] cardClusterArray, int startIndex, int len) { if (len == 0) { return true; } int i; if (len % 3 == 2) { //移除一对（两张牌），胡牌中必须包含一对 for (i = startIndex; i < cardClusterArray.length; i++) { if (cardClusterArray[i] >= 2) { cardClusterArray[i] -= 2; if (AI.isPingHu(cardClusterArray, startIndex, len - 2)) { return true; } cardClusterArray[i] += 2; } } } else { //是否是顺子 int loopCount = cardClusterArray.length - 2; for (i = startIndex; i < loopCount; i++) { int idx1 = i + 1; int idx2 = i + 2; int type1 = HandCards.getCardLeftValueByClusterIndex(i); int type2 = HandCards.getCardLeftValueByClusterIndex(idx1); int type3 = HandCards.getCardLeftValueByClusterIndex(idx2); if (cardClusterArray[i] > 0 && cardClusterArray[idx1] > 0 && cardClusterArray[idx2] > 0 && type1 < 4 && type2 < 4 && type3 < 4) { cardClusterArray[i] -= 1; cardClusterArray[idx1] -= 1; cardClusterArray[idx2] -= 1; if (AI.isPingHu(cardClusterArray, startIndex, len - 3)) { return true; } cardClusterArray[i] += 1; cardClusterArray[idx1] += 1; cardClusterArray[idx2] += 1; } } //三个一样的牌（暗刻） for (i = startIndex; i < cardClusterArray.length; i++) { if (cardClusterArray[i] >= 3) { cardClusterArray[i] -= 3; if (AI.isPingHu(cardClusterArray, startIndex, len - 3)) { return true; } cardClusterArray[i] += 3; } } } return false; } /** * 递归方式判断平胡 * * @param mycards 手牌 * @return true表示可以胡牌 */ public static boolean isPingHu(HandCards mycards) { int[] cardClusterArray = mycards.getCardClusterArray(); int totals = mycards.getCardTotals(); if (totals % 3 != 2) { return false; } return AI.isPingHu(cardClusterArray, mycards.getClusterValidStartIndex(), totals); } public static void main(String[] args) { HandCards handCards = new HandCards(new int[]{11, 12, 13, 22, 23, 24, 33, 33, 33, 36, 36}); System.out.println(Arrays.toString(handCards.getCardClusterArray())); System.out.println(Arrays.toString(handCards.getCards())); for (int i = handCards.getClusterValidStartIndex(); i <= handCards.getClusterValidEndIndex(); i++) { int card = handCards.getCardByClusterIndex(i); if (card > 0) { int num = handCards.getCardNum(card); System.out.println(num + "张 " + CardType.getCardName(card)); } } boolean bool = isPingHu(handCards); System.out.println("是否胡牌：" + bool); } }