Subroutine anaylsis

Question 1

What data type does the GetIndexOfSquare subroutine return?

Answer 1

Int

Question 2

What parameters does the GetIndexOfSquare subroutine take in?

Answer 2

int SquareReference

Question 3

What is the squareReference variable?

Answer 3

• A two digit number where the 1st integer is the row of the grid and the second is the column
• It references a square on the grid

Question 4

How is squareReference calculated?

Answer 4

Row*10 + column

Question 5

Is Squarerefernce Internal or user facing and why?

Answer 5

It is user facing because SR is how the user interacts with the program by entering the square row and then the column.

Question 6

What is the returned by GetIndexOfSquare?

Answer 6

An int value that is the index of the square in the list of squares.

Question 7

How are the squares mapped to the List board?

Answer 7

The squares are mapped sequentially and go from left to right.

Question 8

What is the purpose of the GetIndexOfSquare subroutine?

Answer 8

To convert a square location to its index the the List board.

Question 9

How does the GetIndexOfSquare sub work?

Answer 9

It works by extracting the row and the column by using using Mod and div.
It then calculates the index by : (row -1) * 10 + column-1

Question 10

What are the limitations of the board size?

Answer 10

The board cannot have more than 9 columns

Question 11

What is the parameter for the CheckSquareInbounds sub?

Answer 11

int squareReference

Question 12

What is the return value for CheckSquareInbounds?

Answer 12

A bool value that realates to whether the SR passed is is a valid square or not

Question 13

What is the purpose of the CheckSquareInbounds sub?

Answer 13

It is to verify if the SR inputed by the user is a square that exists on the board

Question 14

How does the CheckSquareInbounds sub work?

Answer 14

It first calculates the row and column values of the SR.
IF the row value is less than 1 or greater than the number of rows then false is returned
if the column value is less than 1 or greater than the number of columns then false is returned
else true is returned

Question 15

What is the return value for CheckifGameOver?

Answer 15

• Bool value
• relates to whether the game has finished or not

Question 16

How does the CheckifGameOver sub work?

Answer 16

It checks each sqaure for the following:
* If the current square is a kotla and if it is occupied by the opposing players mirza; if true then return true;
* If the current square contains a mirza and who it belongs two
if true it sets the playerhasmirza value to true
* The subroutine returns the Nand value of p1mirza and p2mirza

Question 17

What are the parameters for CheckSquareIsValid?

Answer 17

int squareReference, Bool startSquare

Question 18

What is Bool startSquare?

Answer 18

A bool value that represents whether the square that is being checked is the first square or the destination square

Question 19

What is the return value of CheckSquareIsValid?

Answer 19

A Boo value that represnts whether the square that is passed is a validsquare for its given purpose. e.g if the selected square can be a start square

Question 20

How does CheckSquareIsValid work?

Answer 20

• It first checks if the square is in bounds.
• If not then false is returned
• then it checks if there is a piece occupying the square. If the square is empty then it can not be a start square and vice versa
• if the square is occupied by a piece that belongs to the current player it can only be a start square
• if the square is occupied by a piece that belongs to the other player then it can not be a start square

Question 21

What is the purpose of createBoard?

Answer 21

To create the board for the game

Question 22

How does CreateBoard work?

Answer 22

• It works by using a nested for loop with limits to the number of rows || columns depending on the loop to check which squares are to whose kotlas.
• When these squares are found they are assigned to each player
• every other square is just a normal square
• The squares are then added to the list

Question 23

What is the parameter for CreateRyottMoveOption?

Answer 23

int direction

Question 24

What is the direction variable

Answer 24

Direction is an int value that specifies what way up the board a peice should move. Positive is going from top to bottom so the direction for p1 is 1

Question 25

What is the return value for CreateRyottMoveOption?

Answer 25

It is moveOption (a list of possible moves)

Question 26

What is a moveoption object?

Answer 26

moveOption is a list of possible moves that an option can make

Question 27

What is the move object?

Answer 27

Move is like a vector as it consists of a row change and column change

Question 28

What is the purpose of CreateRyottMoveOption?

Answer 28

To get a list of all possible moves for a ryott.

Question 29

How does CreateRyottMoveOption work?

Answer 29

* A new moveoption is instantiated * Then each possible move that a ryott can make is added to the moveoption list

Question 30

What is the parameter for SameAs?

Answer 30

Player Aplayer

Question 31

What is the return value for SameAs?

Answer 31

A bool value that represents whether the player that is passed in is the same as the player that calls the sub

Question 32

How does SameAs work?

Answer 32

It checks to see if the player that is passed as an argument has the same name as the player that calls the sub. If they are the same then true is returned

Question 33

What are the parameters for CheckIfThereIsAMoveToSquare?

Answer 33

Int StartSquareReference Int FinishSquareReference

Question 34

What is the return value of CheckIfThereIsAMoveToSquare?

Answer 34

A bool value that represents whether there is a move to the finishSquare

Question 35

How does CheckIfThereIsAMoveToSquare work?

Answer 35

* It works out what the row and column are for the start and finish square * It then checks every possible move to see if it will land on the finishsquare * it does this by adding the current moves row and column change to start row and column and checks if it is equal to the finish row and column * if equal then true is returned if not then false is returned