NAME

Array::Utils - small utils for array manipulation

SYNOPSIS

use Array::Utils qw(:all);

my @a = qw( a b c d );
my @b = qw( c d e f );

# symmetric difference
my @diff = array_diff(@a, @b);

# intersection
my @isect = intersect(@a, @b);

# unique union
my @unique = unique(@a, @b);

# check if arrays contain same members
# (probably in different order)

if ( same_members(@a, @b) ) {
	# do something
}

DESCRIPTION

A small pure-perl module containing list manipulation routines. The module emerged because I was tired to include same utility routines in numerous projects.

FUNCTIONS

unique

Returns an array of unique items in the arguments list.

intersect

Returns an intersection of two arrays passed as arguments.

array_diff

Return symmetric difference of two arrays passed as arguments.

same_members

If two arrays passed as arguments contain same members the function returns true, even if the members are contained in different order.

BUGS

None known yet

AUTHOR

Sergei A. Fedorov <zmij@cpan.org>

I will be happy to have your feedback about the module.

COPYRIGHT

This module is Copyright (c) 2007 Sergei A. Fedorov. All rights reserved.

You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file.

WARRANTY

This is free software. IT COMES WITHOUT WARRANTY OF ANY KIND.