List::Priority - Perl extension for a list that manipulates objects by their priority

NAME

List::Priority - Perl extension for a list that manipulates objects by their priority

SYNOPSIS

  use List::Priority;

  # Create an instance
  $list = List::Priority->new();

  # Insert some elements, each woth a unique priority
  $list->insert(2,'World!');
  $list->insert(5,'Hello');
  $list->insert(3,' ');

  # Print
  while ($list->pop()) {
          print $_;
  }

If you want to handle multiple data bits by their order of importance - This one's for you.

Logic: Precedence to highest priority object. If more than one object hold the highest priority - FIFO is king.

Duplicate objects are currently not allowed.

I'd like to thank Joseph N. Hall and Randal L. Schwartz for their excellent book ``Effective Perl Programming'' for one of the code hacks...

new - Constructor

  $p_list = List::Priority->new();

new is the constructor for List::Priority objects

insert - List insertion

  $result = $p_list->insert($priority, $scalar);

Inserts the scalar to the list

Arguments: - Priority must be numeric. - Scalar can be any scalar, including references (objects)

Return value: 1 on success, a string describing the error upon failure

pop - List extraction

  $object = $p_list->pop();

Extracts the scalar from the list according to the specified logic.

Arguments: - None.

Return value: The object on success, undef upon failure

None. All interfaces are OO.