DUPLICATE |
説明 変数のクローン (ディープコピー) を返します。元の変数は参照しません。
戻り値 変数のクローン
カテゴリ 構造体関数、システム関数
関数のシンタックス
    Deplicate("variable_name")
関連項目 StructCopy、その他の 構造体関数、『ColdFusion MX 開発ガイド』の第35章の「XML および WDDX の使用」 の「ColdFusion XML オブジェクトの変更」
ヒストリ ColdFusion MX: 動作の変更 : この関数は、XML オブジェクトに使用できます。
パラメータ
使用方法 この関数を使用して、ネストした構造体やクエリーなどの複雑な構造体をコピーします。
メモ: | CFC をコピーしようとすると、Duplicate 関数は例外を返します。
メモ: | この関数では、cfobject タグや CreateObject 関数から返された COM、CORBA、JAVA のオブジェクトはコピーできません。配列要素や構造体フィールドが COM、CORBA、JAVA オブジェクトの場合、その配列や構造体はコピーできません。
例
    <h3>Duplicate の例</h3>
    <cfset s1 = StructNew()>
    <cfset s1.nested  = StructNew()>
    <cfset s1.nested.item = "original">
    <cfset copy = StructCopy(s1)>
    <cfset clone = Duplicate(s1)>
    <!--- 元の値を修正 --->
    <cfset s1.nested.item = "modified">
    <cfoutput>
    <p>コピーには修正された値が含まれます。#copy.nested.item#</p>
    <p>コピーには元の値が含まれます。#clone.nested.item#</p>
    </cfoutput>

VARIABLE_NAME |
コピーを作成する変数の名前です。