Finds the position of an element in an array.
iPos = ArrayFind (aArray, aElem [, iMaxIndex])
Variable | Description |
---|---|
iPos | The returned position. INTEGER. |
aArray | The array to search. ARRAY OF ANYTYPE. |
aElem | The element to find. ANYTYPE. |
iMaxIndex | Optional: The number of elements to search. INTEGER. |
ArrayFind searches the array for the element aElem, and returns the index value of the element. If you specify iMaxIndex, ArrayFind searches only the first iMaxIndex elements; otherwise, the entire array is searched.
If aArray is a multi-dimensional array, you need to specify which sub-array to search. ArrayFind treats each dimension of a multi-dimensional array as an array within an array.
If it does not find aElem, ArrayFind returns zero (0).
[ ] INTEGER aiTempPerDay[5][4] [ ] [-] testcase arrayfind_example () [ ] [-] aiTempPerDay = {...} [ ] {10, 12, 8, 17} [ ] {-1, 0, 17, -9} [ ] {14, 1, 1, 0} [ ] {75, 32, 18, 103} [ ] {9, -7, -2, 3} [ ] Print (ArrayFind (aiTempPerDay[1], 8)) // Prints 3 [ ] Print (ArrayFind (aiTempPerDay[5], -7)) // 2 [ ] Print (ArrayFind (aiTempPerDay[4], 103, 3)) // 0 [ ] Print (ArrayFind (aiTempPerDay[2], 20)) // 0 [ ] Print (ArrayFind (aiTempPerDay, {-1, 0, 17, -9})) // 2