Table of Contents
Advertisement
StructFindKey
Description
Searches recursively through a substructure of nested arrays, structures, and other elements, for
structures whose values match the search key in the value parameter.
Returns
An array that contains structures with values that match value.
Category
Structure functions
Function syntax
StructFindKey(top, value, scope)
See also
Structure functions
Parameters
Parameter
top
value
scope
Usage
Returns an array that includes one structure for each of the specified values it finds. The fields of
each of these structures are:
•
: value held in the found key
Value
•
: string that can be used to reach the found key
Path
•
: parent object that contains the found key
Owner
A structure's keys are unordered.
Example
<cfset aResults = StructFindKey( #request#, "bass" )>
Description
ColdFusion object (structure or array) from which to start search. This attribute
requires an object, not a name of an object.
String or a variable that contains one for which to search.
• one: returns one matching key. Default.
• all: returns all matching keys
StructFindKey
701
Advertisement
Table of Contents
