Core Function Grep

Revision as of 04:22, 22 April 2012

Grep( <pattern>, <array>, <flag> )

Description

Returns a new array consisting of the elements of the input array that match the given regex pattern.

Parameters

pattern

A regular expression pattern to use.

array

The array to use.

flag

Optional; If the flag is higher than 0 the search will be inverted and everything that does not match will be returned instead of everything that does match. (Default is 0)

Return Value

Success - Returns 1.

Failure - Returns 0.

Remarks

This also includes Hash values with the array values.

Example

Return everything that matches

my $array = array( "Test123", "moo", "cat", "dog555", "meows"  );
my $lol = Grep( m/\d+/, $array );
foreach($lol as $c)
{
	println("Value: $c");
}

Return everything that does not match (by setting the flag to 1)

my $array = array( "Test123", "moo", "cat", "dog555", "meows"  );
my $lol = Grep( m/\d+/, $array, 1 );
foreach($lol as $c)
{
	println("Value: $c");
}