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	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

Related

• ArrayAppend

• ArrayAvg

• ArrayClear

• ArrayContains

• ArrayContainsNoCase

• ArrayDelete

• ArrayDeleteAt

• ArrayDeleteNoCase

• ArrayEach

• ArrayEvery

• ArrayFilter

• ArrayFindAll

• ArrayFindAllNoCase

• ArrayFindNoCase

• ArrayFirst

• ArrayGetMetadata

• ArrayIndexExists

• ArrayInsertAt

• ArrayIsDefined

• ArrayLast

• ArrayMap

• ArrayMax

• ArrayMedian

• ArrayMerge

• ArrayMid

• ArrayMin

• ArrayNew

• ArrayPop

• ArrayPrepend

• ArrayPush

• ArrayRange

• ArrayReduce

• ArrayReduceRight

• ArrayResize

• ArrayReverse

• ArraySet

• ArrayShift

• ArraySlice

• ArraySome

• ArraySort

• ArraySplice

• ArraySum

• ArraySwap

• ArrayToList

• ArrayToStruct

• ArrayUnshift