NAME Games::Poker::HandEvaluator - Perl extension for blah blah blah SYNOPSIS use Games::Poker::HandEvaluator qw(handval evaluate); use Games::Cards; my $Poker = new Games::Cards::Game; my $Deck = new Games::Cards::Deck ($Poker, "Deck"); $Deck->shuffle; # Deal out the hands my $hand = Games::Cards::Hand->new($Poker, "Hand") ; $Deck->give_cards($hand, 7); print $hand->print("short"), "\n"; # Hand: JC 7C 8C JH 3C 7S 5C print handval(evaluate($hand)), "\n"; # Flush (J 8 7 5 3) Or just: my $hand_a = evaluate("Jc 7c 8c Jh 3c 7s 5c"); my $hand_b = evaluate("9d 5d Ks 7h 5s 7s 4c"); if ($hand_a > $hand_b) { print handval($hand_a), " beats ", handval($hand_b); # Flush (J 8 7 5 3) beats TwoPair (7 5 K) } DESCRIPTION This is an XS wrapper around the "libpoker" library, found at <http://www.pokersource.org/>. It provides two functions, which are not exported by default, "evaluate" and "handval". "evaluate" turns a hand, as described either by a "Games::Card::CardSet" object or a simple string, into an integer representing the best poker play for that hand. If the hand cannot be parsed, 0 is returned. This integer value can be compared with other hand evaluations; the higher the integer, the better the hand. "handval" turns that value into a short textual description. SEE ALSO http://www.pokersource.org/ AUTHOR Simon Cozens, <simon@kasei.com> COPYRIGHT AND LICENSE Copyright 2003 by Simon Cozens This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.