ArrayMap

Iterates over every entry of the array and calls the closure function to work on the element of the array.

The returned value will be set at the same index in a new array and the new array will be returned

Method Signature

ArrayMap(array=[array], callback=[function:Function], parallel=[boolean], maxThreads=[integer], initialValue=[any])

Arguments

Argument	Type	Required	Description	Default
array	array	true	The array to reduce
callback	function:Function	true	The function to invoke for each item. The function will be passed 3 arguments: the current item, and the current index, and the original array. You can alternatively pass a Java Function which will only receive the 1st arg. The function should return the value that will be set at the same index in the new array.
parallel	boolean	false		false
maxThreads	integer	false
initialValue	any	false

Examples

Script Syntax

Run Example

complexData = [ 
	{
		A : 4
	},
	{
		A : 18
	},
	{
		A : 51
	}
];
newArray = arrayMap( complexData, ( Any item ) => {
	return item.A;
} );
writeDump( newArray );

Result: [4, 18, 51]

Additional Examples

Run Example

aNames = [ 
	"Marcus",
	"Sarah",
	"Josefine"
];
dump( aNames );
newNames1 = arrayMap( aNames, ( Any item, Any index, Any arr ) => {
	return {
		"name" : item
	};
} );
dump( newNames1 );
// member function
newNames2 = aNames.map( ( Any item, Any index, Any arr ) => {
	return {
		"name" : item
	};
} );
dump( newNames2 );

Related

• ArrayPrepend
• ArrayResize
• ArrayReduce
• ArrayMerge
• ArrayIndexExists
• ArrayIsDefined
• ArrayFindAll
• ArrayFindAllNoCase
• ArraySum
• ArraySplice
• ArrayReduceRight
• ArrayReverse
• ArrayFind
• ArrayFindNoCase
• ArrayContains
• ArrayContainsNoCase
• ArrayPush
• ArrayGetMetadata
• 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