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