NAME
Algorithm::MasterMind - Framework for algorithms that solve the MasterMind game
VERSION
This document describes Algorithm::MasterMind version 0.0.1
SYNOPSIS
use Algorithm::MasterMind;DESCRIPTION
Includes common functions used in Mastermind solvers; it should not be used directly, but from derived classes
INTERFACE
new ( $options )
Normally to be called from derived classes
add_rule( $combination, $result)
Adds a rule (set of combination and its result as a hash) to the set of rules. These rules represent the information we've got on the secret code.
check_combination( $secret_code, $combination )
Checks a combination against the secret code, returning a hashref with the number of blacks (correct in position) and whites (correct in color, not position)
check_rule ($rule, $combination)
Same as check_combination, except that a rule contains a combination and how it scored against the secret code
issue_first ()
Issues the first combination, which might be generated in a particular way
issue_next()
Issues the next combination
feedback()
Obtain the result to the last combination played
guesses()
Total number of guesses
evaluated()
Total number of combinations checked to issue result
number_of_rules ()
Returns the number of rules in the algorithm
rules()
Returns the rules (combinations, blacks, whites played so far) y a reference to array
matches( $string )
Returns a hash with the number of matches, and whether it matches every rule with the number of blacks and whites it obtains with each of them
hashify ( $string )
Turns a string into a hash, to help with comparisons. Used internally, mainly.
not_in_combination( $string)
Returns the letters from the alphabet that are _not_ in this combination. Might be useful for certain strategies.
random_combination
Combines randomly the alphabet, issuing, you guessed it, a random combination.
CONFIGURATION AND ENVIRONMENT
Algorithm::MasterMind requires no configuration files or environment variables.
DEPENDENCIES
Algorithm::Evolutionary, but only for one of the strategies.
INCOMPATIBILITIES
None reported.
BUGS AND LIMITATIONS
No bugs have been reported.
Please report any bugs or feature requests to bug-algorithm-mastermind@rt.cpan.org, or through the web interface at http://rt.cpan.org.
AUTHOR
JJ Merelo <jj@merelo.net>
LICENCE AND COPYRIGHT
Copyright (c) 2009, JJ Merelo <jj@merelo.net>. All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.
DISCLAIMER OF WARRANTY
BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.