StructKeyArray

Search
ColdFusion CFML Reference User Guide
Applies to: ColdFusion

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Description

Finds the keys in a ColdFusion structure.

Returns

An array of keys; if structure does not exist, ColdFusion throws an exception.

Category

Structure functions

Syntax 

StructKeyArray(structure)

See also

Structure functions; Modifying a ColdFusion XML object in the Developing ColdFusion Applications

Parameters

Parameter

Description

structure

Structure from which to extract a list of keys.

Example 

<cfscript>
       myStruct.John={age=30,skill="vocals"};
       myStruct.Paul={age=31,skill="guitar and vocals"};
       myStruct.George={age=32,skill="guitar"};
       myStruct.Ringo={age=33,skill="drums"};
       myNewArray=StructKeyArray(myStruct); //Finds the keys in struct myStruct
       WriteDump(myNewArray);
       // Try to return keys in an array that does not exist
       try{
             StructKeyArray(anotherArray);
       }
       catch (any s){
             WriteOutput(s.message); // Display message that anotherArray does not exist
       }
</cfscript>

Output

structkeyarray output
structkeyarray output

Using member function 

<cfscript>
       myStruct = {a:1,b=2,c=3,d=4,e=5};
       myKeyArray=myStruct.keyArray();
       WriteDump(myKeyArray);
</cfscript>