ColdC: Function/Method Reference: insert()

LIST insert(LIST list, INTEGER pos, ANY value)

This function inserts value into list before the element specified by the integer pos. If pos is less than one or is more than one more than the length of list, then the error ~range is thrown.

Examples:

insert([2, 3, 4], 3, 'foo) 
=> [2, 3, 'foo, 4] 

insert(["foo", 'bar, ~none], 4, 'baz)
=> ["foo", 'bar, ~none, 'baz]