CFLib.org – Common Function Library Project

arrayFind(array, valueToFind)

Last updated April 30, 2008

author

Larry C. Lyons

Version: 2 | Requires: CF6 | Library: DataManipulationLib

Description:
The arrayFind function performs a case sensitive search to find the index number of a value in a single dimension array using the java.util.List indexOf method. Because this function performs a case sensitive search, Harry or hArry etc., would not be found (if the item is harry). Also since java arrays start at 0, I modified the returned value to conform to CFMX array index values.

Return Values:
Returns a number, 0 if no match is found.

Example:

<cfset arry = listToArray("tom, dick, harry, phred")>

<cfset test = arrayFind(arry,"tom")>

returns a 1

<cfset test2 = arrayFind(arry,"Tom")>

returns a 0 (not found)

Parameters:

Name Description Required
array Array to search. Yes
valueToFind Value to find. Yes

Full UDF Source:

<!---
 The arrayFind function uses the java.util.list indexOf function to find an element in an array.
 v1 by Nathan Dintenfas.
 
 @param array 	 Array to search. (Required)
 @param valueToFind 	 Value to find. (Required)
 @return Returns a number, 0 if no match is found. 
 @author Larry C. Lyons (larryclyons@gmail.com) 
 @version 2, April 30, 2008 
--->
<cffunction name="arrayFind" access="public" hint="returns the index number of an item if it is in the array" output="false" returntype="numeric">

<cfargument name="array" required="true" type="array">
<cfargument name="valueToFind" required="true" type="string">

<cfreturn (arguments.array.indexOf(arguments.valueToFind)) + 1>
</cffunction>
blog comments powered by Disqus

Search CFLib.org


Latest Additions

Kevin Cotton added
date2ExcelDate
May 5, 2016

Raymond Camden added
CapFirst
April 25, 2016

Chris Wigginton added
loremIpsum
January 18, 2016

Gary Stanton added
calculateArrival...
November 19, 2015

Sebastiaan Naafs - van Dijk added
getDaysInQuarter
November 13, 2015

Created by Raymond Camden / Design by Justin Johnson