STRUCTKEYLIST  
説明

構造体からキーを取り出します。

 
戻り値

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

 
カテゴリ

構造体関数

 
関数のシンタックス
StructKeyList(structure [, delimiter])
 
関連項目

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

 
パラメータ

 
使用方法

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

 
<!--- この例は、StructKeyList を使用して構造体のキーのリストを作成する方法を示しています。StructNew 
関数を使用して構造体を作成し、ユーザーがフォームフィールドに入力した情報をその中に格納します。 --->
<!--- このセクションでは、構造体を作成し、[送信] ボタンが押されたかどうかを調べます。 
押された場合は、フォームに入力された情報を使用して、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>    
<html>
<head>
   <title>StructKeyList 関数</title>
</head>
<body>
<h3>StructKeyList 関数</h3>
<h3>Employees 構造体のキーのリストを作成</h3>
<p> この例では、StructNew 関数を使用して、"employee" という名前の構造体を作成します。これは、従業員情
報を格納するための構造体です。各フィールドに格納する情報は下のフォームで入力します。</p>
<p>従業員情報を構造体に格納したら、<b>StructKeyList</b> 関数を使用して、構造体のキーのリストを作成し
ます。</p>
<p>このコードでは、情報をデータベースに挿入する方法については示していません。 
データベースへの挿入を行う方法については、「cfquery」を参照してください。
<hr size = "2" color = "#0000A0">
<form action = "structkeylist.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 = StructKeyList(employee,"<li>")>
   <p>構造体のキー :</p>
   <ul>
   <li>   <cfoutput>#keysToStruct#</cfoutput>
   </ul>
   <p>これらが適切なフィールドであれば、新しい従業員情報の処理が可能です。 
適切でない場合は、アプリケーションの修正を検討してください。</p>
</cfif>
STRUCTURE  
構造体です。この中にあるキーのリストを取り出します。
DELIMITER  
オプションです。リスト内のキーの区切り文字を指定します。デフォルト値はカンマ (,) です。