
Contents > CFML Reference > ColdFusion Functions > StructFindValue

StructFindValue

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.

Structure functions

StructFindValue( top, value [, scope])

Structure functions

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	one: function returns one matching key (default) all: function returns all matching keys

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

one: function returns one matching key (default)
all: function returns all matching keys

The fields of each structure in the returned array are:

Key: name of the key in which the value was found
Path: string which could be used to reach the found key
Owner: parent object that contains the found key

A structure's keys are unordered.

<cfset aResults = StructFindValue( #request#, "235" )>


Contents > CFML Reference > ColdFusion Functions > StructFindValue

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/functa96.htm