Searches recursively through a substructure of nested arrays, structures, and other elements for structures with values that match the search key in the value parameter.
An array that contains structures with values that match the search key value. If none are found, returns an array of size 0.
StructFindValue( top, value [, scope])
| Parameter | Description |
|---|---|
top |
ColdFusion object (a structure or an array) from which to start search. This attribute requires an object, not a name of an object. |
value |
String or a variable that contains one for which to search. The type must be a simple object. Arrays and structures are not supported. |
scope |
|
The fields of each structure in the returned array are:
Key: name of the key in which the value was foundPath: string which could be used to reach the found keyOwner: parent object that contains the found keyA structure's keys are unordered.
<cfset aResults = StructFindValue( #request#, "235" )>