Games::Jumble - Create and solve Jumble word puzzles.
Version 0.09
use Games::Jumble; my $jumble = Games::Jumble->new(); $jumble->set_num_words(6); $jumble->set_word_lengths_allowed(5,6); $jumble->set_word_lengths_not_allowed(7,8); $jumble->set_dict('/home/doug/crossword_dict/unixdict.txt'); my @jumble = $jumble->create_jumble; foreach my $word (@jumble) { print "$word\n"; } # Solve jumbled word my @good_words = $jumble->solve_word('rta'); if (@good_words) { foreach my $good_word (@good_words) { print "$good_word\n"; } } else { print "No words found\n"; } # Create jumbled word my $word = 'camel'; my $jumbled_word = $jumble->jumble_word($word); print "$jumbled_word ($word)\n";
Games::Jumble is used to create and solve Jumble word puzzles.
Games::Jumble
Currently Games::Jumble will create random five- and six-letter jumbled words from dictionary. Future versions of Games::Jumble will allow user to create custom jumbles by using a user defined word file with words of any length. Individual words of any length may be jumbled by using the jumble_word() method.
jumble_word()
Default number of words is 5. Default dictionary is '/usr/dict/words'. Dictionary file must contain one word per line.
This is the constructor for a new Games::Jumble object.
my $jumble = Games::Jumble->new();
If num_words is passed, this method will set the number of words for the puzzle, otherwise number of words is set to default value of 5.
num_words
my $jumble = Games::Jumble->new(num_words=>$num_words);
If lengthx is(are) passed, this method will set word lengths that will be used when creating jumble. The default setting will use all word lengths. Note: Allow all is designated by empty hash.
lengthx
If lengthx is(are) passed, this method will set word lengths that will be skipped when creating jumble. The default setting will not skip any word lengths. Note: Skip none is designated by empty hash.
This method creates the jumble.
This method will create a jumbled word. Returns scalar containing jumbled word.
This method will solve a jumbled word. Returns list of solved words.
This method will solve an incomplete word as needed for a crossword. WORD format: 'c?m?l' where question marks are used a placeholders for unknown letter. Returns list of solved words.
Doug Sparling, <usr_bin_perl at yahoo.com>
<usr_bin_perl at yahoo.com>
Please report any bugs or feature requests to bug-games-jumble at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Games-Jumble. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-games-jumble at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc Games::Jumble
You can also look for information at:
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Games-Jumble
CPAN Ratings
http://cpanratings.perl.org/d/Games-Jumble
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Games-Jumble
Search CPAN
http://search.cpan.org/dist/Games-Jumble
Tim Maher for pointing out some outdated documentation in the Synopsis.
Copyright 2001-2007 Doug Sparling, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Games::Jumble, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Games::Jumble
CPAN shell
perl -MCPAN -e shell install Games::Jumble
For more information on module installation, please visit the detailed CPAN module installation guide.