ArrayPrepend

Append a value to the start an array

Method Signature

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

Arguments

Argument	Type	Required	Description	Default
array	modifiableArray	true	The array to prepend to
value	any	true	The value to prepend

Examples

Prepend a value to an array

Uses the arrayPrepend function to prepend a value to the beginning of an array and shifts the positions of the existing elements.

Run Example

someArray = [ 
	3,
	2,
	1
];
arrayPrepend( someArray, 4 );
writeDump( someArray );

Result: [4,3,2,1]

Prepend a value to an array using the Array member function

Invoking the prepend function on an array is the same as running arrayPrepend.

Run Example

doctorArray = [ 
	"Eccleston",
	"Tennant",
	"Smith",
	"Capaldi"
];
doctorArray.prepend( "Hurt" );
writeDump( doctorArray );

Result: ['Hurt','Eccleston','Tennant','Smith','Capaldi']

Additional Examples

Run Example

someArray = [ 
	3,
	2,
	1
];
arrayPrepend( someArray, 4 );
dump( someArray );
// member function
doctorWhoArray = [
	"Whittaker",
	"Tennant",
	"Baker"
];
doctorWhoArray.prepend( "Hurt" );
dump( doctorWhoArray );

Related

• ArrayResize

• ArrayReduce

• ArrayMerge

• ArrayIndexExists

• ArrayIsDefined

• ArrayFindAll

• ArrayFindAllNoCase

• ArraySum

• ArraySplice

• ArrayReduceRight

• ArrayReverse

• ArrayFind

• ArrayFindNoCase

• ArrayContains

• ArrayContainsNoCase

• ArrayPush

• ArrayGetMetadata

• ArrayMap

• ArrayPop

• ArraySome

• ArrayDelete

• ArrayDeleteNoCase

• ArrayMedian

• ArrayAvg

• ArrayToList

• ArrayFilter

• ArrayClear

• ArrayRange

• ArraySwap

• ArrayShift

• ArrayToStruct

• ArrayUnshift

• ArraySlice

• ArrayMid

• ArrayInsertAt

• ArrayNew

• ArraySet

• ArrayMax

• ArrayFirst

• ArrayDeleteAt

• ArraySort

• ArrayEach

• ArrayAppend

• ArrayEvery

• ArrayLast

• ArrayMin