Share via


Array.insert Function

Inserts a single item into a specified index of an Array object. This function is static and can be invoked without creating an instance of the object.

Array.insert(array, index, item);

Arguments

Term

Definition

array

The array to insert the item into.

index

The index location where item should be inserted.

item

The object to add to the array.

Remarks

Use the insert function to insert an item into a specified index of an Array object. The index value of items that are greater than index is increased by one.

Calling the insert function and passing a negative value for index counts backward from the end of the array. Floating point values are rounded down to a whole number value.

Example

The following example shows how to use the insert function to insert an item into an array.

var a = ['a', 'b', 'd', 'e'];
Array.insert(a, 2, 'c');
// View the results: "a,b,c,d,e"
alert(a);

See Also

Reference

Array Object

Array Type Extensions

Other Resources

Language Reference