Struct shakmaty_syzygy::Tablebase
source · Expand description
A collection of tables.
Implementations
sourceimpl<S: Position + Clone + Syzygy> Tablebase<S>
impl<S: Position + Clone + Syzygy> Tablebase<S>
sourcepub fn add_directory<P: AsRef<Path>>(&mut self, path: P) -> Result<usize>
pub fn add_directory<P: AsRef<Path>>(&mut self, path: P) -> Result<usize>
Add all relevant tables from a directory.
Tables are selected by filename, e.g. KQvKP.rtbz
. The files are not
actually opened. This happens lazily when probing.
Returns the number of added table files.
Errors
Returns an error result when:
- The
path
does not exist. path
is not a directory.- The process lacks permissions to list the directory.
sourcepub fn add_file<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
pub fn add_file<P: AsRef<Path>>(&mut self, path: P) -> Result<()>
Add a table file.
The file is not actually opened. This happens lazily when probing.
Errors
Returns an error when no file exists at the given path or the
filename does not indicate that it is a valid table file
(e.g. KQvKP.rtbz
).
sourcepub fn probe_wdl(&self, pos: &S) -> Result<Wdl, SyzygyError>
pub fn probe_wdl(&self, pos: &S) -> Result<Wdl, SyzygyError>
Probe tables for the Wdl
value of a position.
This indicates if the position is winning, lost or drawn with or without the 50-move rule.
Errors
See SyzygyError
for possible error
conditions.
sourcepub fn probe_dtz(&self, pos: &S) -> Result<Dtz, SyzygyError>
pub fn probe_dtz(&self, pos: &S) -> Result<Dtz, SyzygyError>
Probe tables for the Dtz
value of a position.
Min-maxing the DTZ of the available moves guarantees achieving the optimal outcome under the 50-move rule.
Errors
See SyzygyError
for possible error
conditions.