renju.h

/*
Copyright (C) 2011 by the Computer Poker Research Group, University of Alberta
*/

#ifndef _RENJU_H
#define _RENJU_H
#define __STDC_FORMAT_MACROS
#include <inttypes.h>
#include<string.h>

#include "net.h"

#define VERSION_MAJOR 2
#define VERSION_MINOR 0
#define VERSION_REVISION 0


#define MAX_PLAYERS 2
#define MAX_BOARD_CARDS 7
#define MAX_LINE_LEN READBUF_LEN

#define NUM_ACTION_TYPES 3
#define BOARD_SIZE 15

typedef struct {
  uint8_t type;  //black=1 or white=2  3 giveup
  uint8_t col;
  uint8_t row;
} Action;

typedef struct {
    //保存棋局信息
  uint8_t* board;
  uint8_t ltype;
  uint8_t lcol;
  uint8_t lrow;
}BoardState;
void initBoardState(BoardState *boardstate);
uint8_t getPiece(const BoardState* bs, const uint8_t col,const uint8_t row);
uint8_t addPiece(BoardState*bs, const uint8_t col,const uint8_t row,const uint8_t type);

void clearBoard(BoardState*bs);

typedef struct {
  //保存动作次数
  uint8_t numActions;
  //记录回合次数
  uint8_t numRounds;
  //当前应该发送消息至玩家号
  uint8_t viewingPlayer;
  //当前玩家
  uint8_t currentPlayer;
  //先手玩家
  uint8_t firstPlayer;
  //结束flag,0无胜，1，2对应黑白胜，-1错误完成
  uint8_t finished;
  //对局次数
  uint32_t numGames;
} MatchState;

/*初始化棋局状态*/
void initState( MatchState *state );
/*单次对局完成重置棋盘信息*/
void resetState(MatchState *state);
/* 检查是不是把棋子下在了已有棋子上 */
int isValidAction(const BoardState *boardState,const Action *action);
/* 包含对下子类型的推断，下子合法性，下子后的状态变化 */
void doAction( Action *action, MatchState *state ,BoardState* boardState );

/* 返回0为无玩家胜利，返回1为执黑玩家胜，返回2为执白玩家胜*/
int isWin(const BoardState *boardState, const uint8_t type);

/* 检查该是否能取胜 */
int checkWinningPiece(const BoardState *boardState, const Action *action);

/* 检查某一条线是否为五连 */
int checkLine(const BoardState *boardState, const Action *action, const uint8_t secondCol, const uint8_t secondRow);

/* returns non-zero if hand is finished, zero otherwise */
#define stateFinished( constStatePtr ) ((constStatePtr)->finished)

/* get the current player to act in the state */
uint8_t currentPlayer( const MatchState *state );

/* the current round */
uint8_t numRounds( const MatchState *state );

/* number of actions performed */
uint8_t numAction( const MatchState *state );

/* 读一下标识符，并且解析一下状态
	returns number of characters consumed on success, -1 on failure
   state will be modified even on a failure to read */
int readMatchState( const char *string,const MatchState *state );

/* print a state to a string, as viewed by viewingPlayer
   returns the number of characters in string, or -1 on error
   DOES NOT COUNT FINAL 0 TERMINATOR IN THIS COUNT!!! */
int printState( const MatchState *state,
		const int maxLen, char *string );

/* print a state to a string, as viewed by viewingPlayer
   returns the number of characters in string, or -1 on error
   DOES NOT COUNT FINAL 0 TERMINATOR IN THIS COUNT!!! */
int printMatchState( const MatchState *state, const BoardState *boardState,
		     const int maxLen, char *string );

/* read an action, returning the action in the passed pointer
   action and size will be modified even on a failure to read
   returns number of characters consumed on succes, -1 on failure */
int readAction( const char *string, Action *action );

/* print an action to a string
   returns the number of characters in string, or -1 on error
   DOES NOT COUNT FINAL 0 TERMINATOR IN THIS COUNT!!! */
int printAction( const Action *action,
		 const int maxLen, char *string );
#endif