Core Function IndexNotOfAny

Revision as of 12:06, 21 August 2013

Reports the index of the first none occurrence of any characters or array of strings in a specified string.

Description

Reports the index of the first none occurrence of any characters or array of strings in a string.

expression

The string to use.

needle

The characters to not find OR an array of strings not to find.

pos

Optional; Position to start the search from within the expression.

Default: 0

case

Optional; Case sensitive option

false = Case sensitive search

true = Case insensitive search

Default: false

count

Optional; The amount of characters to check before quitting the search

Default: expression length - pos

Return Value

Success: Returns position of the first found character in the string that does not match the needle.

Failure: Returns -1.

Remarks

None.

Example

Case sensitive

// Search for non-occurrence of characters
println(   IndexNotOfAny("The quick brown FoX", "The")   );
// Search for non-occurrence of a string
println(   IndexNotOfAny("The quick brown FoX", array("The"))   );
// Search for non-occurrence of array of strings
println(   IndexNotOfAny("The quick brown FoX", array("brown ", "The ", "quick "))   );

Case insensitive

// Search for non-occurrence of characters
println(   IndexNotOfAny("The quick brown FoX", "tHE", 0, true)   );
// Search for non-occurrence of a string
println(   IndexNotOfAny("The quick brown FoX", array("THE"), 0, true)   );
// Search for non-occurrence of array of strings
println(   IndexNotOfAny("The quick brown FoX", array("BROWN ", "ThE ", "Quick "), 0, true)   );