Description

Searches an array for the first position of a specified object. The function searches for simple objects such as strings and numbers or for complex objects such as structures. When the second parameter is a simple object, string searches are case-sensitive. This function does not support searches for COM and CORBA objects.

Returns

Index in the array of the first match, or 0 if there is no match.

Category

Function syntax

ArrayFind(array, object)

ArrayFind(array, function(arrayElement) {return true|false;})

See also

Parameters

Parameter

Description

array

Array to search in.

function

Inline function executed for each element in the array. Returns true if the array element matches the search criterion.

object

Object to search for.

arrayElement Array element being accessed.

Example

<cfscript>
writeDump(ArrayFind(["STRING","string"], "string"));
writeDump(ArrayFind(["STRING","string"], function(s) {if(compare(s, "string")==0) return true; return false;}));
</cfscript>

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy