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

History

ColdFusion (2018 release): Introduced named parameters.

Syntax

ArrayFind(array, value)
ArrayFind(array,callback)

See also

Parameters

Parameter

Description

array

Array to search in.

callback

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

value

Value to search for in the array.

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