NAME

Games::Bingo::Card - a helper class for Games::Bingo

SYNOPSIS

        use Games::Bingo::Card;

        my $b = Games::Bingo-E<gt>new(90);
        my $card = Games::Bingo::Card-E<gt>new($b);

        my $bingo = Games::Bingo-E<gt>new(90);
        $card-E<gt>validate($bingo);

        use Games::Bingo::Card;

        my $p = Games::Bingo::Card-E<gt>new();
        $p-E<gt>populate();

DESCRIPTION

The Games::Bingo::Card class suits the simple purpose of being able to generate bingo cards and validating whether they are valid in during a game where a player indicate victory.

It is also used by Games::Bingo::Print to hold the generated bingo cards before they are printed.

METHODS

new

This method generates an object representing a bingo card.

The constructor, takes no arguments.

populate

This method is the main method of the class. It populates the card objects with a predefined number of randomly picked numbers which can be printed using the Games::Bingo::Print class.

Init uses the function in Games::Bingo::Column and Games::Bingo::ColumnCollection, which are use to generate the necessary random numbers to generate the card and set the them in the necessary columns.

_insert

This is the private method which is used to insert numbers onto the card in the Bingo::Games::Card class.

Populate takes to arguments, the row and the number, it resolves the column using _resolve_column.

_resolve_column

Resolve column is method used to resolve where on the card a specified number should go. It takes a number and returns an integer indicating a column.

_integrity_check

This method is a part of the work-around, which was made in the populate method, it checks whether the populated card holds 12 numbers return a boolean value indicating succes or failure.