ArrayPush

ArrayPush

Išči

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Description

Adds an element or an object to the end of an array.

Returns

The new size of the array.

Syntax

1
ArrayPush(array, value)

Member function

1
array.push(value)

History

New in ColdFusion (2021 release)

Parameters

Parameter

Required/Optional

Description

array

Required

Array to which a value or object is to be added.

value

Required

The value or object to be added to the array.

Examples

Example 1

1
2
3
4
5
<cfscript>
    arr=[23,65,187,81,9]
    ArrayPush(array=arr,value=17)
    WriteOutput("The size of the array is now: " & arrayLen(arr))
</cfscript>

Output

The size of the array is now: 6

Example 2

1
2
3
4
5
<cfscript>
    arr=[1,3,5,7,9]
    ArrayPush(arr,[11,13]) // using an array as value
    WriteOutput("The size of the array is now: " & arrayLen(arr))
</cfscript>

Output

The size of the array is now: 6

Example 3

1
2
3
4
5
6
7
8
<cfscript>
    arr=[{"id":101,"name":"John"},
         {"id":102,"name":"Paul"},
         {"id":103,"name":"George"}
        ]
    ArrayPush(arr,{"id":104,"name":"Ringo"})
    WriteOutput("The size of the array is now: " & arrayLen(arr))
</cfscript>

Output

The size of the array is now: 6

Example 4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<cfscript>
    Q1=queryNew(data=[
                 {"id":1,"title":"Moby Dick"},
                 {"id":2,"title":"Great Expectations"}
             ]);
    Q2=queryNew(data=[
                 {"id":3,"title":"Hamlet"},
                 {"id":4,"title":"Macbeth"}
             ]);
    arrOfQ=[Q1,Q2]
    Q3=queryNew(data=[
                 {"id":5,"title":"Frankenstein"},
                 {"id":6,"title":"Metamorphosis"}
             ]);
    ArrayPush(arrOfQ,Q3)
    WriteOutput("The size of the array is now: " & arrayLen(arrOfQ))
</cfscript>

Output

The size of the array is now: 3