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.
ArrayContains(array=[array], value=[any], substringMatch=[boolean])
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 |
- ArrayAppend
- ArrayAvg
- ArrayClear
- ArrayContainsNoCase
- ArrayDelete
- ArrayDeleteAt
- ArrayDeleteNoCase
- ArrayEach
- ArrayEvery
- ArrayFilter
- ArrayFind
- 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