構造体内のキーを取り出します。

キーの配列。structure が存在しない場合は例外が発生します。

構造体関数

StructKeyArray(structure)

構造体関数、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 の「ColdFusion XML オブジェクトの変更」

構造体のキーはソートされていません。

<!--- この例は、StructKeyArray 関数を使用して、構造体から配列にキーをコピーする方法を示しています。 
StructNew 関数を使用して構造体を作成し、フォームフィールドに入力された情報をその構造体のフィールドに格
納します。 --->
<h3>StructKeyArray の例</h3>
<h3>Employee 構造体からのキー取り出し</h3>   
<!-- 構造体を作成します。[送信] が押されたかどうかを確認します。押された場合は、フォームに入力された情報
を使用して、employee 構造体のフィールドを定義します。 ----->
<cfset employee = StructNew()> 
<cfif Isdefined("Form.Submit")>
   <cfif Form.Submit is "OK">
      <cfset employee.firstname = FORM.firstname>
      <cfset employee.lastname = FORM.lastname>
      <cfset employee.email = FORM.email>
      <cfset employee.phone = FORM.phone>
      <cfset employee.company = FORM.company> 
   <cfelseIf Form.Submit is "Clear">
      <cfset rc = StructClear(employee)>
   </cfif>
</cfif>    
<p> この例では、StructNew 関数を使用して、"employee" という名前の構造体を作成します。これは、従業員情
報を格納するための構造体です。構造体の各フィールドに格納する情報はフォームで入力します。従業員情報を構
造体に格納したら、StructKeyArray 関数を使用して、構造体のすべてのキーを配列にコピーします。</p>
<hr size = "2" color = "#0000A0">
<form action = "structkeyarray.cfm">
<table cellspacing = "2" cellpadding = "2" border = "0">
   <tr>
   <td>名前 :</td>
   <td><input name = "firstname" type = "text" 
      value = "" hspace = "30" maxlength = "30"></td>
   </tr>
   <tr>
   <td>姓 :</td>
   <td><input name = "lastname" type = "text" 
      value = "" hspace = "30" maxlength = "30"></td>
   </tr>
   <tr>
   <td>電子メール :</td>
   <td><input name = "email" type = "text" 
      value = "" hspace = "30" maxlength = "30"></td>
   </tr>
   <tr>
   <td>電話番号 :</td>
   <td><input name = "phone" type = "text" 
      value = "" hspace = "20" maxlength = "20"></td>
   </tr>
   <tr>
   <td>会社名 :</td>
   <td><input name = "company" type = "text" 
      value = "" hspace = "30" maxlength = "30"></td>
   </tr>
   <tr>
   <td><input type = "submit" name = "submit" 
      value = "送信"></td>
   <td><b>フォームの送信後、下方向にスクロールすると配列が表示されます。</b>
   </td>
   </tr>
</table>
</form>
<cfif NOT StructISEmpty(employee)> 
   <hr size = "2" color = "#0000A0">
   <cfset keysToStruct = StructKeyArray(employee)>
   <cfloop index = "i" from = "1" to = "#ArrayLen(keysToStruct)#">
      <p><cfoutput>Key#i# は #keysToStruct[i]#</cfoutput> です。</p>
      <p><cfoutput>Value#i# は #employee[keysToStruct[i]]#</cfoutput> です。
      </p>
   </cfloop>
</cfif>