STRUCTAPPEND |
説明 ある構造体を別の構造体に追加します。
戻り値 正常に完了した場合は true、そうでない場合は false。
カテゴリ 構造体関数
関数のシンタックス
    StructAppend(struct1, struct2, overwriteFlag)
関連項目 構造体関数、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 の「ColdFusion XML オブジェクトの変更」
ヒストリ ColdFusion MX: 動作の変更 : この関数は、XML オブジェクトに使用できます。
パラメータ
使用方法 この関数は、struct2 のフィールドと値を struct1 に追加します。struct2 は変更されません。struct1 に既に struct2 のフィールドが含まれている場合、struct2 の値で上書きするかどうかは overwriteFlag により決定されます。 構造体のキーはソートされていません。
例
    <html>
    <body>
    <!---- Name 構造体を作成 --->
    <cfset nameCLK=StructNew()>
    <cfset nameCLK.first="Chris">
    <cfset nameCLK.middle="Lloyd">
    <cfset nameCLK.last="Gilson">
    <!--- address 構造体を作成 --->
    <cfset addrCLK=StructNew()>
    <cfset addrCLK.street="17 Gigantic Rd">
    <cfset addrCLK.city="Watertown">
    <cfset addrCLK.state="MA">
    <cfset addrCLK.zip="02472">
    <!---- Person 構造体を作成 --->
    <cfset personCLK=StructNew()>
    <cfset personCLK.name=#nameCLK#>
    <cfset personCLK.addr=#addrCLK#>
    <!--- Append を実行する前の Person 構造体の内容を表示 --->
    <p>
    Append 呼び出し<b>前</b>の person 構造体 :<br>
    <cfloop collection=#personCLK# item="myItem">
    <cfoutput>
    #myItem#<br>
    </cfoutput>
    </cfloop>
    <!--- address 構造体を person 構造体のトップレベルに結合 --->
    <cfset bSuccess = StructAppend( personCLK, addrCLK )>

    <!--- Append を実行した後の person 構造体の内容を表示 --->
    <p>
    Append の呼び出し<b>後</b>の person 構造体 :<br>
    <cfloop collection=#personCLK# item="myItem">
       <cfoutput>
          #myItem#<br>
       </cfoutput>
    </cfloop>

STRUCT1 |
struct2 の追加先の構造体です。

STRUCT2 |
struct1 に追加するデータを含んだ構造体です。

OVERWRITEFLAG |

- true または "Yes": struct2 の値で、struct1 の対応する値を上書きします (デフォルト)。
- false または "No": struct2 の値で、struct1 の対応する値を上書きしません。