INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

NAME
    Array::Parallel - Sorting Parallel Arrays

VERSION
    This document describes version 0.01 of Array::Parallel, released
    January 2004

SYNOPSIS
          use Array::Parallel;

          @your_ratings = (2, 3, 1);
          @husbands = ('fred', 'archie', 'homer');
          @wives = ('wilma', 'edith', 'marge');

          $array = Array::Parallel->new(\@your_ratings, \@husbands, \@wives);
          ($your_ratings, $husbands, $wives) = $array->sort('num');

          for my $num ( (0 .. $#{@{$your_ratings}} ) ) {
              print "You rated $husbands->[$num] and $wives->[$num] number $your_ratings->[$num]\n";
          }

DESCRIPTION
    Does Parallel Array sorting. Sorting 1 Array and then matching up the
    keys from the first one to sort a second array, third array, ect. Take a
    look at the Synopsis if you are confussed about what I mean.

    A more efficent way would be to use hash keys instead of using this
    module. But, this might be good for a lot of cases. I would test this
    module with the extremes of what data you expect before trusting it
    though.

METHODS
    Just two methods for now

  new

      Just the constuctor
      Usage: $a = Array::Parallel->new(\@sorted_array, \@next, ..);

  sort

      Sorts arrays to first array. Returns references to all arrays supplied. Takes 1 arguement. Either "num" to sort $a <=> $b, and "cmp" to sort $a cmp $b
      Usage: ($sorted_array, $next, ..) = $a->sort("num");

EXPORT
    OO Nothing

HISTORY
    0.01    Version .01 - Everythins new. Functions are: new (constructor)
            and sort/parasort. Probably bugy. I wouldn't trust it for
            important things.

BUGS
    Unknown, but they're there.

    Please use the Module RIGHT. Not much in way of error messenging (well,
    not error messenging actually). As long as you give it arrays of equal
    length it won't freak out. If it doesn't work right tell me. This is a
    beta for a reason.

TODO
    They call this version .01 for a reason. I have to do a lot.
    Contribution will be well accepted :-)

AUTHOR
    Will Gunther <lt>williamgunther@aol.com<gt>

SEE ALSO
    the perl manpage.

Copyright (C) 2004 Will Gunther

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