Searches recursively through a substructure of nested arrays, structures, and other elements, for structures whose values match the search key in the value parameter.
An array that contains structures with values that match value.
Structure functions
StructFindKey
(top, value, scope)
Structure functions; "Structure functions" in Chapter 5, "Using Arrays and Structures," in ColdFusion MX Developers Guide
Parameter | Description |
top |
ColdFusion object (structure or array) from which to start search. This parameter requires an object, not a name of an object. |
value |
String or a variable that contains one for which to search. |
scope |
|
Returns an array that includes one structure for each of the specified values it finds. The fields of each of these structures are:
Value
: value held in the found keyPath
: string that can be used to reach the found keyOwner
: parent object that contains the found keyA structures keys are unordered.
<cfset aResults = StructFindKey( #request#, "bass" )>