]> git.sesse.net Git - stockfish/blob - src/position.h
Tidy up comments in thread.cpp
[stockfish] / src / position.h
1 /*
2   Stockfish, a UCI chess playing engine derived from Glaurung 2.1
3   Copyright (C) 2004-2008 Tord Romstad (Glaurung author)
4   Copyright (C) 2008-2010 Marco Costalba, Joona Kiiski, Tord Romstad
5
6   Stockfish is free software: you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation, either version 3 of the License, or
9   (at your option) any later version.
10
11   Stockfish is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with this program.  If not, see <http://www.gnu.org/licenses/>.
18 */
19
20 #if !defined(POSITION_H_INCLUDED)
21 #define POSITION_H_INCLUDED
22
23 #include <cassert>
24
25 #include "bitboard.h"
26 #include "move.h"
27 #include "types.h"
28
29
30 /// The checkInfo struct is initialized at c'tor time and keeps info used
31 /// to detect if a move gives check.
32
33 struct CheckInfo {
34
35     explicit CheckInfo(const Position&);
36
37     Bitboard dcCandidates;
38     Bitboard pinned;
39     Bitboard checkSq[8];
40 };
41
42
43 /// The StateInfo struct stores information we need to restore a Position
44 /// object to its previous state when we retract a move. Whenever a move
45 /// is made on the board (by calling Position::do_move), an StateInfo object
46 /// must be passed as a parameter.
47 class Position;
48
49 struct StateInfo {
50   Key pawnKey, materialKey;
51   Value npMaterial[2];
52   int castleRights, rule50, pliesFromNull;
53   Score value;
54   Square epSquare;
55
56   Key key;
57   Bitboard checkersBB;
58   PieceType capturedType;
59   StateInfo* previous;
60 };
61
62
63 /// The position data structure. A position consists of the following data:
64 ///
65 ///    * For each piece type, a bitboard representing the squares occupied
66 ///      by pieces of that type.
67 ///    * For each color, a bitboard representing the squares occupied by
68 ///      pieces of that color.
69 ///    * A bitboard of all occupied squares.
70 ///    * A bitboard of all checking pieces.
71 ///    * A 64-entry array of pieces, indexed by the squares of the board.
72 ///    * The current side to move.
73 ///    * Information about the castling rights for both sides.
74 ///    * The initial files of the kings and both pairs of rooks. This is
75 ///      used to implement the Chess960 castling rules.
76 ///    * The en passant square (which is SQ_NONE if no en passant capture is
77 ///      possible).
78 ///    * The squares of the kings for both sides.
79 ///    * Hash keys for the position itself, the current pawn structure, and
80 ///      the current material situation.
81 ///    * Hash keys for all previous positions in the game for detecting
82 ///      repetition draws.
83 ///    * A counter for detecting 50 move rule draws.
84
85 class Position {
86
87   // No defaul, copy c'tor or assignment allowed, default c'tor will not be
88   // generated anyhow because of user-defined c'tors.
89   Position(const Position&);
90   Position& operator=(const Position&);
91
92 public:
93   Position(const Position& pos, int threadID);
94   Position(const std::string& fen, bool isChess960, int threadID);
95
96   // Text input/output
97   void from_fen(const std::string& fen, bool isChess960);
98   const std::string to_fen() const;
99   void print(Move m = MOVE_NONE) const;
100
101   // The piece on a given square
102   Piece piece_on(Square s) const;
103   bool square_is_empty(Square s) const;
104
105   // Side to move
106   Color side_to_move() const;
107
108   // Bitboard representation of the position
109   Bitboard empty_squares() const;
110   Bitboard occupied_squares() const;
111   Bitboard pieces(Color c) const;
112   Bitboard pieces(PieceType pt) const;
113   Bitboard pieces(PieceType pt, Color c) const;
114   Bitboard pieces(PieceType pt1, PieceType pt2) const;
115   Bitboard pieces(PieceType pt1, PieceType pt2, Color c) const;
116
117   // Number of pieces of each color and type
118   int piece_count(Color c, PieceType pt) const;
119
120   // The en passant square
121   Square ep_square() const;
122
123   // Current king position for each color
124   Square king_square(Color c) const;
125
126   // Castling rights
127   bool can_castle(CastleRight f) const;
128   bool can_castle(Color c) const;
129   Square castle_rook_square(CastleRight f) const;
130
131   // Bitboards for pinned pieces and discovered check candidates
132   Bitboard discovered_check_candidates() const;
133   Bitboard pinned_pieces() const;
134
135   // Checking pieces and under check information
136   Bitboard checkers() const;
137   bool in_check() const;
138
139   // Piece lists
140   const Square* piece_list(Color c, PieceType pt) const;
141
142   // Information about attacks to or from a given square
143   Bitboard attackers_to(Square s) const;
144   Bitboard attackers_to(Square s, Bitboard occ) const;
145   Bitboard attacks_from(Piece p, Square s) const;
146   static Bitboard attacks_from(Piece p, Square s, Bitboard occ);
147   template<PieceType> Bitboard attacks_from(Square s) const;
148   template<PieceType> Bitboard attacks_from(Square s, Color c) const;
149
150   // Properties of moves
151   bool pl_move_is_legal(Move m, Bitboard pinned) const;
152   bool move_is_pl(const Move m) const;
153   bool move_gives_check(Move m, const CheckInfo& ci) const;
154   bool move_is_capture(Move m) const;
155   bool move_is_capture_or_promotion(Move m) const;
156   bool move_is_passed_pawn_push(Move m) const;
157   bool move_attacks_square(Move m, Square s) const;
158
159   // Piece captured with previous moves
160   PieceType captured_piece_type() const;
161
162   // Information about pawns
163   bool pawn_is_passed(Color c, Square s) const;
164
165   // Doing and undoing moves
166   void do_move(Move m, StateInfo& st);
167   void do_move(Move m, StateInfo& st, const CheckInfo& ci, bool moveIsCheck);
168   void undo_move(Move m);
169   void do_null_move(StateInfo& st);
170   void undo_null_move();
171
172   // Static exchange evaluation
173   int see(Move m) const;
174   int see_sign(Move m) const;
175
176   // Accessing hash keys
177   Key get_key() const;
178   Key get_exclusion_key() const;
179   Key get_pawn_key() const;
180   Key get_material_key() const;
181
182   // Incremental evaluation
183   Score value() const;
184   Value non_pawn_material(Color c) const;
185   Score pst_delta(Piece piece, Square from, Square to) const;
186
187   // Game termination checks
188   bool is_mate() const;
189   template<bool SkipRepetition> bool is_draw() const;
190
191   // Plies from start position to the beginning of search
192   int startpos_ply_counter() const;
193
194   // Other properties of the position
195   bool opposite_colored_bishops() const;
196   bool has_pawn_on_7th(Color c) const;
197   bool is_chess960() const;
198
199   // Current thread ID searching on the position
200   int thread() const;
201
202   int64_t nodes_searched() const;
203   void set_nodes_searched(int64_t n);
204
205   // Position consistency check, for debugging
206   bool is_ok(int* failedStep = NULL) const;
207   void flip();
208
209   // Global initialization
210   static void init();
211
212 private:
213
214   // Initialization helper functions (used while setting up a position)
215   void clear();
216   void put_piece(Piece p, Square s);
217   void set_castle(int f, Square ksq, Square rsq);
218   void set_castling_rights(char token);
219   bool move_is_legal(const Move m) const;
220
221   // Helper functions for doing and undoing moves
222   void do_capture_move(Key& key, PieceType capture, Color them, Square to, bool ep);
223   void do_castle_move(Move m);
224   void undo_castle_move(Move m);
225
226   template<bool FindPinned>
227   Bitboard hidden_checkers() const;
228
229   // Computing hash keys from scratch (for initialization and debugging)
230   Key compute_key() const;
231   Key compute_pawn_key() const;
232   Key compute_material_key() const;
233
234   // Computing incremental evaluation scores and material counts
235   Score pst(Piece p, Square s) const;
236   Score compute_value() const;
237   Value compute_non_pawn_material(Color c) const;
238
239   // Board
240   Piece board[64];             // [square]
241
242   // Bitboards
243   Bitboard byTypeBB[8];        // [pieceType]
244   Bitboard byColorBB[2];       // [color]
245
246   // Piece counts
247   int pieceCount[2][8];        // [color][pieceType]
248
249   // Piece lists
250   Square pieceList[2][8][16];  // [color][pieceType][index]
251   int index[64];               // [square]
252
253   // Other info
254   int castleRightsMask[64];    // [square]
255   Square castleRookSquare[16]; // [castleRight]
256   StateInfo startState;
257   int64_t nodes;
258   int startPosPly;
259   Color sideToMove;
260   int threadID;
261   StateInfo* st;
262   int chess960;
263
264   // Static variables
265   static Score pieceSquareTable[16][64]; // [piece][square]
266   static Key zobrist[2][8][64];          // [color][pieceType][square]
267   static Key zobEp[64];                  // [square]
268   static Key zobCastle[16];              // [castleRight]
269   static Key zobSideToMove;
270   static Key zobExclusion;
271 };
272
273 inline int64_t Position::nodes_searched() const {
274   return nodes;
275 }
276
277 inline void Position::set_nodes_searched(int64_t n) {
278   nodes = n;
279 }
280
281 inline Piece Position::piece_on(Square s) const {
282   return board[s];
283 }
284
285 inline bool Position::square_is_empty(Square s) const {
286   return piece_on(s) == PIECE_NONE;
287 }
288
289 inline Color Position::side_to_move() const {
290   return sideToMove;
291 }
292
293 inline Bitboard Position::occupied_squares() const {
294   return byTypeBB[0];
295 }
296
297 inline Bitboard Position::empty_squares() const {
298   return ~occupied_squares();
299 }
300
301 inline Bitboard Position::pieces(Color c) const {
302   return byColorBB[c];
303 }
304
305 inline Bitboard Position::pieces(PieceType pt) const {
306   return byTypeBB[pt];
307 }
308
309 inline Bitboard Position::pieces(PieceType pt, Color c) const {
310   return byTypeBB[pt] & byColorBB[c];
311 }
312
313 inline Bitboard Position::pieces(PieceType pt1, PieceType pt2) const {
314   return byTypeBB[pt1] | byTypeBB[pt2];
315 }
316
317 inline Bitboard Position::pieces(PieceType pt1, PieceType pt2, Color c) const {
318   return (byTypeBB[pt1] | byTypeBB[pt2]) & byColorBB[c];
319 }
320
321 inline int Position::piece_count(Color c, PieceType pt) const {
322   return pieceCount[c][pt];
323 }
324
325 inline const Square* Position::piece_list(Color c, PieceType pt) const {
326   return pieceList[c][pt];
327 }
328
329 inline Square Position::ep_square() const {
330   return st->epSquare;
331 }
332
333 inline Square Position::king_square(Color c) const {
334   return pieceList[c][KING][0];
335 }
336
337 inline bool Position::can_castle(CastleRight f) const {
338   return st->castleRights & f;
339 }
340
341 inline bool Position::can_castle(Color c) const {
342   return st->castleRights & ((WHITE_OO | WHITE_OOO) << c);
343 }
344
345 inline Square Position::castle_rook_square(CastleRight f) const {
346   return castleRookSquare[f];
347 }
348
349 template<>
350 inline Bitboard Position::attacks_from<PAWN>(Square s, Color c) const {
351   return StepAttacksBB[make_piece(c, PAWN)][s];
352 }
353
354 template<PieceType Piece> // Knight and King and white pawns
355 inline Bitboard Position::attacks_from(Square s) const {
356   return StepAttacksBB[Piece][s];
357 }
358
359 template<>
360 inline Bitboard Position::attacks_from<BISHOP>(Square s) const {
361   return bishop_attacks_bb(s, occupied_squares());
362 }
363
364 template<>
365 inline Bitboard Position::attacks_from<ROOK>(Square s) const {
366   return rook_attacks_bb(s, occupied_squares());
367 }
368
369 template<>
370 inline Bitboard Position::attacks_from<QUEEN>(Square s) const {
371   return attacks_from<ROOK>(s) | attacks_from<BISHOP>(s);
372 }
373
374 inline Bitboard Position::checkers() const {
375   return st->checkersBB;
376 }
377
378 inline bool Position::in_check() const {
379   return st->checkersBB != EmptyBoardBB;
380 }
381
382 inline bool Position::pawn_is_passed(Color c, Square s) const {
383   return !(pieces(PAWN, opposite_color(c)) & passed_pawn_mask(c, s));
384 }
385
386 inline Key Position::get_key() const {
387   return st->key;
388 }
389
390 inline Key Position::get_exclusion_key() const {
391   return st->key ^ zobExclusion;
392 }
393
394 inline Key Position::get_pawn_key() const {
395   return st->pawnKey;
396 }
397
398 inline Key Position::get_material_key() const {
399   return st->materialKey;
400 }
401
402 inline Score Position::pst(Piece p, Square s) const {
403   return pieceSquareTable[p][s];
404 }
405
406 inline Score Position::pst_delta(Piece piece, Square from, Square to) const {
407   return pieceSquareTable[piece][to] - pieceSquareTable[piece][from];
408 }
409
410 inline Score Position::value() const {
411   return st->value;
412 }
413
414 inline Value Position::non_pawn_material(Color c) const {
415   return st->npMaterial[c];
416 }
417
418 inline bool Position::move_is_passed_pawn_push(Move m) const {
419
420   Color c = side_to_move();
421   return   piece_on(move_from(m)) == make_piece(c, PAWN)
422         && pawn_is_passed(c, move_to(m));
423 }
424
425 inline int Position::startpos_ply_counter() const {
426   return startPosPly + st->pliesFromNull; // HACK
427 }
428
429 inline bool Position::opposite_colored_bishops() const {
430
431   return   piece_count(WHITE, BISHOP) == 1
432         && piece_count(BLACK, BISHOP) == 1
433         && opposite_color_squares(piece_list(WHITE, BISHOP)[0], piece_list(BLACK, BISHOP)[0]);
434 }
435
436 inline bool Position::has_pawn_on_7th(Color c) const {
437   return pieces(PAWN, c) & rank_bb(relative_rank(c, RANK_7));
438 }
439
440 inline bool Position::is_chess960() const {
441   return chess960;
442 }
443
444 inline bool Position::move_is_capture_or_promotion(Move m) const {
445
446   assert(move_is_ok(m));
447   return move_is_special(m) ? !move_is_castle(m) : !square_is_empty(move_to(m));
448 }
449
450 inline bool Position::move_is_capture(Move m) const {
451
452   // Note that castle is coded as "king captures the rook"
453   assert(move_is_ok(m));
454   return (!square_is_empty(move_to(m)) && !move_is_castle(m)) || move_is_ep(m);
455 }
456
457 inline PieceType Position::captured_piece_type() const {
458   return st->capturedType;
459 }
460
461 inline int Position::thread() const {
462   return threadID;
463 }
464
465 #endif // !defined(POSITION_H_INCLUDED)