NAME

Auction::Lot - Information on an item in an auction

SYNOPSIS

  my $a_item = Auction::Lot->new($itemid);

  my $itemid      = $a_item->itemid;
  my $id          = $a_item->id;
  my $reserve     = $a_item->reserve;
  my $description = $a_item->description;
  my $expiry_day  = $a_item->expiry_day;
  my $expiry_time = $a_item->expiry_time;
  my @time_left   = $a_item->time_remaining;

DESCRIPTION

This provides information on an item in an auction

YOU HAVE TO GET YOURSELF A DATABASE HANDLE!! I don't know how you connect to your database, so I leave that for an exercise for the reader.

Oh, alright, here is an example... Auction::Lot->set_db('Main', 'dbi:mysql', 'me', 'noneofyourgoddamnedbusiness', {AutoCommit => 1}); my @handles = Auction::Lot->db_handles; my $dbh = $handles[0];

FACTORY METHODS

new

  my $a_item = Auction::Lot->new($itemid);

Make a new auction item object

INSTANCE METHODS

itemid

  my $itemid = $a_item->itemid;

This will return the itemid

description

  my $description = $a_item->description;

This will return the item's description

reserve

  my $reserve = $a_item->reserve

This will return the item's reserve.

id

  my $id = $a_item->id;

This is synomous with itemid

expiry_day

  my $expiry_day = $a_item->expiry_day;

This will return the day of expiry as a Date::Simple;

expiry_time

  my $expiry_time = $a_item->expiry_time;

This will return the time of expiry of the auction (on the expiry_date)

time_remaining

  my @time_remaining = $a_item->time_remaining.

This will return a list (days, hours, minutes, seconds) of the time remaining until the end of the auction.

is_active

  my $is_active = $a_item->is_active;

This will be true is the item is still auctionable, that is, that the expiry date of the auction hasn't passed.

BUGS

None known

TODO

Nothing known

COPYRIGHT

Copyright (C) 2001 mwk. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

MWKerr, <coder@stray-toaster.co.uk>