原创干货！麻将平胡算法
此算法基本可以通用于所有麻将的平胡规则，即满足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);
}
}
