Core Function IndexNotOfValue

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

Description

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

Parameters

array

The array to use.

needle

The searched value.

Note:

If needle is a string, the comparison is done in a case-sensitive manner.

(Unless the flag is set to ignore case)

You can set the needle to a Regex such as "m/\d+/" (without quotes) to search for Regexp patterns.

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");
 
my $pos = IndexNotOfValue($arr, "Two");
say "Positon is: $pos"; // 0
 
my $pos = IndexNotOfValue($arr, "One");
say "Positon is: $pos"; // 1