ArrayFind

Array finders and contains functions with and without case sensitivity.

Please note that "contain" methods return a boolean, while "find" methods return an index. If you use a function as the value, it will be used as a search closure or lambda. The signature of the function should be:


    ( value, index ) => {
 	  	return true; // if the value is found, else false
   }

Example:


   array = [ 1, 2, 3, 4, 5 ];
  index = array.find( ( value, index ) -> {
 		return value == 3;
 } );

We recommend you use BoxLang lambdas ( {@code ->} ) for this purpose, so they only act upon the value and index without any side effects. They will be faster and more efficient.

Method Signature

ArrayFind(array=[array], value=[any], substringMatch=[boolean])

Arguments

Argument

Type

Required

Description

Default

array

true

The array to be searched.

value

any

true

The value to find or a closure to be used as a search function.

substringMatch

boolean

false

If true, the search will be a substring match. Default is false. This only works on simple values, not complex ones. For that just use a function filter.

false

Examples

PreviousArrayFilter NextArrayFindAll

Last updated 2 months ago

Method Signature

Arguments

Examples

Related