ArrayAppend

説明

配列要素を任意の配列に追加します。

戻り値

正常に完了した場合は true

カテゴリ

配列関数

関数のシンタックス

ArrayAppend(array, value [,merge])

関連項目

ArrayPrepend、『ColdFusion アプリケーションの開発』のAdding elements to an array

履歴

ColdFusion MX: 動作が変更されました。この関数を XML オブジェクトに対して使用できるようになりました。

パラメータ

パラメータ

説明

array

配列の名前です。

value

配列の最後に追加する値です。

merge

true に設定した場合は、ソース配列に、配列要素が個別に追加されます。false(デフォルト)の場合は、ソース配列の最後に、配列全体が 1 つの要素として追加されます。

<h3>ArrayAppend Example</h3> 
<cfquery name = "GetEmployeeNames" datasource = "cfdocexamples"> 
    SELECT FirstName, LastName FROM Employees 
</cfquery> 
<!--- Create an array> ---> 
<cfset myArray = ArrayNew(1)> 
<!--- Set element one to show where we are. ---> 
<cfset myArray[1] = "Test Value"> 
<!--- Loop through the query; append these names successively to the last  
    element. ---> 
<cfloop query = "GetEmployeeNames"> 
    <cfoutput>#ArrayAppend(myArray, "#FirstName# #LastName#")# 
    </cfoutput>, Array was appended<br> 
</cfloop> 
<!--- Show the resulting array as a list. ---> 
<cfset myList = ArrayToList(myArray, ",")> 
<!--- Output the array as a list. ---> 
<cfoutput> 
    <p>The contents of the array are as follows:</p> 
    <p>#myList#</p> 
</cfoutput>