Core Function IndexNotOfValueAny

IndexNotOfValueAny( <array>, <needle>, <strict>, <ignoreCase>, <skipStringKeys> )

Description

Checks for the non-occurrence of a value (from an array) in an array and returns the first index that does not contain any of the values.

Parameters

array

The array to use.

needle

An array to search for its values.

strict

Optional; If true the the array value and the needle must be same TYPE such as both Int32s.

Note - If "strict" is true when the needle is a Regex then it will require all the values to be STRING or else it will not match.

Default: false

ignoreCase

Optional; Flag to choose if the search will be case sensitive or case insensitive

True: Ignore case and match with case insensitivity

False: Case must be an exact match

Default: false

skipStringKeys

Optional; Flag to choose if the search will ignore all keys in the array that are not numeric

True: Ignore all non-numeric keys such as "Cat" and "Dog" but match with keys like 0 1 2 3 4

False: Match all keys regardless of what they are made of

-1: Match only non-numeric keys and nothing else such as only match "Cat" and "Dog" but not numbers like 0 1 2 3 4

Default: false

Return Value

Success: Returns integer index if the search was successful and located in the array section or a string of the index key if the search was successful in the dictionary section.

Failure: Returns null (It has to return null since it is the only way to make sure that even every possible key match was invalid).

Remarks

None.

Example

my $arr = array("One", "Two", "Three", "Four");
 
$pos = IndexNotOfValueAny($arr, array("Three", "Two"));
say "Positon is: $pos"; // 0
 
$pos = IndexNotOfValueAny($arr, array("Two", "Three"));
say "Positon is: $pos"; // 0
 
$pos = IndexNotOfValueAny($arr, array("One", "Three"));
say "Positon is: $pos"; // 1
 
$pos = IndexNotOfValueAny($arr, array("One", "Two", "Three", "Four"));
say "Positon is: $pos"; // null