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 not case-sensitive. This function does not support searches for COM and CORBA objects.

Note that ArrayFindNoCase() behaves identically to ArrayFind(), except in the special cases where the second parameter is a function or you are searching for a string in an array of strings. When the second parameter is a function, ArrayFind() executes the function for each element in the array and ArrayFindNoCase() searches the array for the function.

Returns

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

Category

History

ColdFusion (2018 release): Made the following changes:

  • Renamed the parameter object to value
  • Renamed function to callback

ColdFusion 9: Added this function.

Function syntax

ArrayFindNoCase(array, value)
ArrayFindNoCase(array, callback)

See also

Parameters

Parameter

Description

array

Array to search in. Valid datatypes in array are:

  • String
  • Boolean
  • Number

value

Value to search for in the array.

callback

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

Example

<cfscript>
	writeDump(ArrayFindNoCase(["STRING","string"], "string"));
	writeDump(ArrayFindNoCase(["STRING","string"], function(s) {
		if(compare(s, "string")==0) 
			return true; 
		else
			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