Contents > CFML Reference > ColdFusion Functions > StructFindKey PreviousNext

StructFindKey

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

Parameter

Description

top

ColdFusion object (structure or 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.

scope

  • one: returns one matching key. Default.
  • all: returns all matching keys

Returns an array that includes one structure for each of the specified values it finds. The fields of each of these structures are:

A structure's keys are unordered.

<cfset aResults = StructFindKey( #request#, "bass" )>

Contents > CFML Reference > ColdFusion Functions > StructFindKey PreviousNext

ColdFusion 9 | ColdFusion 8 | ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX | Forums | Developer Center | Bug Reporting

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6.1/htmldocs/functa95.htm