Functions Index :: A :: ArrayInsert

[<< up one level]

Module:

array :: core

Definition:

ArrayInsert(string array, val new_value, int "index")

Description:

Inserts new_value before array[index] and returns the resulting array. ..

As a result the array is expanded, new_value is positioned at array[index] and all subsequent elements's indexes are increased by one.

If (optional) index is ommited, then new_value is appended to the end of array (same as providing an index with value equal to array.ArrayLen()).

Examples:

a1 = ArrayCreate(AVISource(.1.), AVISource(.2.))

a1 = a1.ArrayInsert(AVISource(.3.))

a1 = a1.ArrayInsert(AVISource(.4.), 0)

# a1 now contains clips {(.4.),(.1.),(.2.),(.3.)}

 

[<< top]

  $notes