ArrayPush

Adds an element or an object to the end of an array, then returns the size of the modified array.

Method Signature

ArrayPush(array=[modifiableArray], value=[any])

Arguments

Argument

Type

Required

Description

Default

array

modifiableArray

true

The array to which the element should be appended.

value

any

true

The element to append. Can be any type.

Examples

Push a value onto an array

This is the full function version of arrayPush to push a value onto the end of the array.

Run Example

arr = [ 
	1,
	2,
	3
];
arrayPush( array=arr, value=42 );
writeOutput( "This array has " & arrayLen( arr ) & " elements." );

Result: This array has 4 elements.

Member function version.

Using the member function. This version also works in ACF2018.

Run Example

arr = [ 
	1,
	2,
	3
];
al = arr.push( 42 );
writeOutput( "This array has " & al & " elements." );

Result: This array has 4 elements.

Push an object onto an array.

This demonstrates pushing an object onto an array.

Run Example

arr = [ 
	[
		1
	],
	[
		"two"
	],
	[
		{
			A : 3
		}
	]
];
al = arr.push( [
	42
] );
writeOutput( "This array has " & al & " elements." );

Result: This array has 4 elements.

Additional Examples

Run Example

numbers = [ 
	1,
	2,
	3,
	4
];
Dump( ArrayPush( numbers, 0 ) ); // Outputs 5
moreNumbers = [
	5,
	6,
	7,
	8
];
Dump( ArrayPush( moreNumbers, 4 ) );
 // Outputs 5

PreviousArrayPrepend NextArrayRange

Last updated 7 months ago

Was this helpful?

hashtagMethod Signature

hashtagArguments

hashtagExamples

hashtagPush a value onto an array

hashtagMember function version.

hashtagPush an object onto an array.

hashtagAdditional Examples

hashtagRelated

Method Signature

Arguments

Examples

Push a value onto an array

Member function version.

Push an object onto an array.

Additional Examples

Related