STRUCTINSERT | |
説明
キーと値のペアを構造体に挿入します。 |
|
戻り値
正常に完了した場合は true。structure が存在しない場合、または key が既に存在して allowoverwrite = "False" の場合は、例外が発生します。 |
|
カテゴリ
構造体関数 |
|
関数のシンタックスStructInsert(structure, key, value [, allowoverwrite ]) |
|
関連項目
構造体関数、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 の「ColdFusion XML オブジェクトの変更」 |
|
ヒストリ
ColdFusion MX: 動作の変更 : この関数は、XML オブジェクトに使用できます。 |
|
パラメータ
|
|
使用方法
構造体のキーはソートされていません。 |
|
例<h1>新しい従業員の追加</h1> <!--- パラメータの初期値を設定 ---> <cfparam name = "FORM.firstname" default = ""> <cfparam name = "FORM.lastname" default = ""> <cfparam name = "FORM.email" default = ""> <cfparam name = "FORM.phone" default = ""> <cfparam name = "FORM.department" default = ""> <cfif FORM.firstname EQ ""> <p>フォームの各項目を入力してください。 <cfelse> <cfoutput> <CFScript> employee = StructNew(); StructInsert(employee, "firstname", FORM.firstname); StructInsert(employee, "lastname", FORM.lastname); StructInsert(employee, "email", FORM.email); StructInsert(employee, "phone", FORM.phone); StructInsert(employee, "department", FORM.department); </CFScript> <p>名前 : #StructFind(employee, "firstname")#</p> <p>姓 : #StructFind(employee, "lastname")#</p> <p>電子メール : #StructFind(employee, "email")#</p> <p>電話番号 : #StructFind(employee, "phone")#</p> <p>部門 : #StructFind(employee, "department")#</p> </cfoutput> <!--- 従業員を追加するカスタムタグを呼び出します。 ---> <CF_ADDEMPLOYEE EMPINFO = "#employee#"> </cfif> <Hr> <form action = "structinsert.cfm"> <p>名前 : <input name = "firstname" type = "text" hspace = "30" maxlength = "30"> <p>姓 : <input name = "lastname" type = "text" hspace = "30" maxlength = "30"> <p>電子メール : <input name = "email" type = "text" hspace = "30" maxlength = "30"> <p>電話番号 : <input name = "phone" type = "text" hspace = "20" maxlength = "20"> <p>部門 : <input name = "department" type = "text" hspace = "30" maxlength = "30"> <p> <input type = "submit" value = "OK"> </form> |
STRUCTURE | |
新しいキーと値のペアを挿入する構造体です。 |
KEY | |
挿入する値を持つキーです。 |
VALUE | |
挿入する値です。 |
ALLOWOVERWRITE | |
オプションです。既存のキーへの上書きを認めるかどうかを指定します。デフォルト値は false です。 |