Judge.h

/********************************************************
*	Judge.h : 用于棋局评判的辅助函数                    *
*	张永锋                                              *
*	zhangyf07@gmail.com                                 *
*	2014.5                                              *
*********************************************************/

/*
	用于检测给定棋局是否为某一方的胜局或是否出现了平局
	这些函数你可能会使用，也可能不需要使用这些函数，这取决于你自己的策略
*/

#ifndef JUDGE_H_
#define JUDGE_H_

/*
	userWin - 判断用户是否赢
	machineWin - 判断机器是否赢
	isTie - 判断是否为平局

	使用这几个函数时请注意以下几个前提
		1. 我们在每一个落子之后(包括用户落子或计算机落子)进行是否出现胜局的判断
		2. 显然，用户落子之后不可能出现计算机反而赢的情况，计算机落子之后也不可能出现用户反而赢的情况
		3. 因此，在用户落子之后，我们只需判断是否用户赢或者出现平局；计算机落子之后同理
		4. 由以上三点保证，每次落子之后我们只需在以落子点核心的四个方向上进行胜局检测就可以了，而不需全盘检索
		5. 三个函数更具体的使用注意事项请见各自的注释
*/

#include "State.h"

/*
	intput:
		(x, y) - 用户的落子点 ( x - 所在行 y - 所在列 左上角为原点 组数下标从0开始计数 )
		(M, N) - 棋盘规模 ( M - 行数 N - 列数 )
		board - 待检测的棋盘二维数组，注意是在落子前的棋盘基础上修改好(x,y)处的值之后的结果
	output:
		true - 用户赢
		false - 用户未赢 注意，由于我们约定检测用户是否赢一定是在用户落子之后，所以此时不需要考虑计算机是否赢
				实际上，计算机一定没有赢，此时的情况只有两种:
				1. 游戏尚未结束，双方都未赢
				2. 游戏以平局结束
				对于以上这两种情况，我们可以用isTie函数进行进一步的判断
*/
//bool userWin(const int x, const int y, const int M, const int N, const Board &board);

/*
	与userWin函数同理，可以参见上述注释
*/
//bool machineWin(const int x, const int y, const int M, const int N, const Board &board);

bool win(int x, int y, int M, int N, const Board &board, char p);
bool win(int x, int y, const HeavyBoard &board, char p);

/*
	为了减少计算量，该函数通过直接检测棋盘是否已满来进行平局判断，而不是对棋盘进行全盘检测
	因此要求:
		1. 必须在进行userWin或machineWin检测发现没有胜局后调用才有意义
		2. 不论在什么情况下，你的策略函数必须给出一个落子点(在某些情况下，你的策略函数可能会发现自己已经毫无选择，
		   不得不在一个能够给对方创造胜局机会的地方落子，此时你的函数也不得不忍痛返回这个落子点)
		3. 你的策略函数返回的每个落子点在落子之前必须是一个有效位置(该位置空&&位于某列的列顶)
	intput:
		N - 棋盘列数
		top - 当前每一列的列顶位置，注意是在落子前的棋盘基础上修改好(x,y)处的值之后的结果
	output:
		true - 出现了平局
		false - 未出现平局，此时游戏尚未结束
*/
bool isTie(int N, const char *top);

#endif