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 |
オプションです。リスト内のキーの区切り文字を指定します。デフォルト値はカンマ (,) です。